NetLocalGroupGetInfo: Unterschied zwischen den Versionen

Aus API-Wiki
Wechseln zu: Navigation, Suche
(Parameter:)
Zeile 5: Zeile 5:
 
<pre>
 
<pre>
 
Declare Function NetLocalGroupGetInfo Lib "netapi32.dll" ( _
 
Declare Function NetLocalGroupGetInfo Lib "netapi32.dll" ( _
ByVal lpwServerName As Long, _
+
                ByVal lpwServerName As Long, _
        ByVal lpwGroupName As Long, _
+
                ByVal lpwGroupName As Long, _
        ByVal Level As Long, _
+
                ByVal Level As Long, _
        ByVal lpBuffer As Long) As Long
+
                ByRef lpBuffer As Long) As Long
 
</pre>
 
</pre>
  
Zeile 17: Zeile 17:
 
:[in] Zeiger auf einen Unicode String der den Gruppennamen angibt.
 
:[in] Zeiger auf einen Unicode String der den Gruppennamen angibt.
 
''Level''
 
''Level''
:[in] Dieser Parameter bestimmt den Typ der im Parameter lpBuffer übergebenen Struktur:
+
:[in] Dieser Parameter bestimmt den Typ der in lpBuffer zurückgegebenen Struktur:
 
::1: lpBuffer zeigt auf eine [[LOCALGROUP_INFO_1]] Struktur
 
::1: lpBuffer zeigt auf eine [[LOCALGROUP_INFO_1]] Struktur
 
''lpBuffer''
 
''lpBuffer''
:[in] Zeiger auf eine LOCALGROUP_INFO_1 Struktur welche von der API mit den Daten der Gruppe befüllt wird.
+
:[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.
  
 
=====Rückgabe(n):=====
 
=====Rückgabe(n):=====

Version vom 20. März 2007, 15:10 Uhr

Die API-Funktion NetLocalGroupGetInfo ermittelt Informationen zu einer lokalen Gruppe.

Declare Function NetLocalGroupGetInfo 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:
1: lpBuffer zeigt auf eine LOCALGROUP_INFO_1 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.

Rückgabe(n):

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

Beispiel:

nicht verfügbar

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 'NetLocalGroupGetInfo ist unter folgenden Betriebssystemen funktionsfähig:

  • Windows NT 3.1 oder später
Verweise: