NetGroupGetInfo: Unterschied zwischen den Versionen
Aus API-Wiki
(→Parameter:) |
|||
Zeile 1: | Zeile 1: | ||
__NOTOC__ | __NOTOC__ | ||
− | + | Die API-Funktion [[NetGroupGetInfo]] ermittelt Informationen zu einer globale Gruppe. | |
− | Die API-Funktion | ||
− | < | + | <code vb> |
Declare Function NetGroupGetInfo Lib "netapi32.dll" ( _ | Declare Function NetGroupGetInfo Lib "netapi32.dll" ( _ | ||
ByVal lpwServerName As Long, _ | ByVal lpwServerName As Long, _ | ||
Zeile 9: | Zeile 8: | ||
ByVal Level As Long, _ | ByVal Level As Long, _ | ||
ByRef lpBuffer As Long) As Long | ByRef lpBuffer As Long) As Long | ||
− | </ | + | </code> |
− | + | ==Parameter== | |
''lpwServerName'' | ''lpwServerName'' | ||
:[in] Zeiger auf einen Unicode String der den Rechnernamen angibt auf dem die Gruppe existiert.<br>Der Rechnername muss mit "\\" beginnen. <br>Wird für diesen Parameter [[NULL]] übergeben, wird der lokale Computer verwendet. | :[in] Zeiger auf einen Unicode String der den Rechnernamen angibt auf dem die Gruppe existiert.<br>Der Rechnername muss mit "\\" beginnen. <br>Wird für diesen Parameter [[NULL]] übergeben, wird der lokale Computer verwendet. | ||
Zeile 25: | Zeile 24: | ||
:[out] In dieser Long Variablen wird der Zeiger auf die Rückgabedaten gespeichert. Dieser Speicherbereich wird vom System allokiert und muss nach der Verwendung mittels [[NetApiBufferFree]] freigegeben werden. Die in dem Speicherbereich abgelegten Informationen richten sich nach dem im Parameter 'Level' angegebenen Wert. Zum Auslesen der in diesem Bereich abgelegten Informationen muss auf weitere API Funktionen wie z.B. [[RtlMoveMemory]] zurückgegriffen werden. | :[out] In dieser Long Variablen wird der Zeiger auf die Rückgabedaten gespeichert. Dieser Speicherbereich wird vom System allokiert und muss nach der Verwendung mittels [[NetApiBufferFree]] freigegeben werden. Die in dem Speicherbereich abgelegten Informationen richten sich nach dem im Parameter 'Level' angegebenen Wert. Zum Auslesen der in diesem Bereich abgelegten Informationen muss auf weitere API Funktionen wie z.B. [[RtlMoveMemory]] zurückgegriffen werden. | ||
− | + | ==Rückgabe== | |
− | War die Funktion erfolgreich, so erfolgt die Rückgabe des Wertes 0 (NERR_Success). | + | 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. | 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 | + | Die API-Funktion [[NetGroupGetInfo]] ist unter folgenden Betriebssystemen funktionsfähig: |
*Windows NT 3.1 oder später | *Windows NT 3.1 oder später | ||
− | + | ==Verweise== | |
*[[NetGroupSetInfo]] | *[[NetGroupSetInfo]] | ||
*[[NetLocalGroupGetInfo]] | *[[NetLocalGroupGetInfo]] | ||
− | [[Kategorie: | + | [[Kategorie:Internet und Netzwerke]] |
Version vom 13. Mai 2008, 10:15 Uhr
Die API-Funktion NetGroupGetInfo ermittelt Informationen zu einer globale Gruppe.
Declare Function NetGroupGetInfo Lib "netapi32.dll" ( _
ByVal lpwServerName As Long, _ ByVal lpwGroupName As Long, _ ByVal Level As Long, _ ByRef lpBuffer 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 in lpBuffer zurückgegebenen 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
lpBuffer
- [out] In dieser Long Variablen wird der Zeiger auf die Rückgabedaten gespeichert. Dieser Speicherbereich wird vom System allokiert und muss nach der Verwendung mittels NetApiBufferFree freigegeben werden. Die in dem Speicherbereich abgelegten Informationen richten sich nach dem im Parameter 'Level' angegebenen Wert. Zum Auslesen der in diesem Bereich abgelegten Informationen muss auf weitere API Funktionen wie z.B. RtlMoveMemory zurückgegriffen werden.
Rückgabe
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 NetGroupGetInfo ist unter folgenden Betriebssystemen funktionsfähig:
- Windows NT 3.1 oder später