NetGroupSetInfo

Aus API-Wiki
Wechseln zu: Navigation, Suche

Die API-Funktion NetGroupSetInfo ändert Informationen einer globale Gruppe.

Declare Function NetGroupSetInfo Lib "netapi32.dll" ( _
				 ByVal lpwServerName As Long, _
        		 ByVal lpwGroupName As Long, _
        		 ByVal Level As Long, _
        		 ByVal lpBuffer As Long, _
        		 ByRef ParmError As Long) As Long

Parameter

lpwServerName

[in] Zeiger auf einen Unicode String der den Rechnernamen angibt auf dem die Gruppe existiert.
Der Rechnername muss mit "\\" beginnen.
Wird für diesen Parameter NULL übergeben, wird der lokale Computer verwendet.

lpwGroupName

[in] Zeiger auf einen Unicode String der den Gruppennamen angibt.

Level

[in] Dieser Parameter bestimmt den Typ der im Parameter lpBuffer übergebenen Struktur:
0: lpBuffer zeigt auf eine GROUP_INFO_0 Struktur
1: lpBuffer zeigt auf eine GROUP_INFO_1 Struktur
2: lpBuffer zeigt auf eine GROUP_INFO_2 Struktur
3: lpBuffer zeigt auf eine GROUP_INFO_3 Struktur
1002: lpBuffer zeigt auf eine GROUP_INFO_1002 Struktur
1005: lpBuffer zeigt auf eine GROUP_INFO_1005 Struktur

lpBuffer

[in] Zeiger auf eine GROUP_INFO_0, GROUP_INFO_1, GROUP_INFO_2, GROUP_INFO_3, GROUP_INFO_1002 oder GROUP_INFO_1005 Struktur welche die neuen Daten der Gruppe enthält.

ParmError

[out] In diesem Longwert wird, im Falle eines ERROR_INVALID_PARAMETER Fehlers, der Index des ersten bemängelten Eintrags der GROUP_INFO Struktur zurückgegeben.

Rückgaben

War die Funktion erfolgreich, so erfolgt die Rückgabe des Wertes 0 (NERR_Success).

Hinweise

Beachten Sie, dass die Funktion nur als Unicode Funktion implementiert ist. Um die von VB automatisch durchgeführte Umwandlung von String Parametern in ANSI Strings zu unterbinden sind die Parameter 'As Long' deklariert und müssen mit StrPtr(MyString) übergeben werden.

Betriebssystem

Die API-Funktion NetGroupSetInfo ist unter folgenden Betriebssystemen funktionsfähig:

  • Windows NT 3.1 oder später

Verweise