NetGetJoinInformation

Aus API-Wiki
Version vom 7. Oktober 2016, 21:23 Uhr von Jochen Wierum (Diskussion | Beiträge)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Zur Navigation springenZur Suche springen
Die druckbare Version wird nicht mehr unterstützt und kann Darstellungsfehler aufweisen. Bitte aktualisiere deine Browser-Lesezeichen und verwende stattdessen die Standard-Druckfunktion des Browsers.

Diese Funktion ermittelt die Statusinformationen des angegebenen Computers, über seinen Mitgliedsstatus.

Declare Function NetGetJoinInformation Lib "NetApi32" ( _
                            ByVal lpServername As Long, _
                            ByRef lpNameBuffer As Long,  _
                            ByRef BufferType As NETSETUP_JOIN_STATUS) As Long

Parameter

lpServername

Zeiger auf einen Unicodestring, der einen Computernamen enthält, von welchem die Statusinformationen gelesen werden sollen.
Dieser Parameter darf NULL sein, dann werden die Informationen vom lokalen Computer ausgelesen.
Übergabe mit StrPtr() empfohlen.

lpNameBuffer

Zeiger auf eine Variable vom Typ Long, welche den Zeiger auf den Rückgabepuffer aufnehmen kann.
Der zurückgegebene Zeiger muss mittels NetApiBufferFree wieder freigegeben werden.
Der Rückgabepuffer ist ein Zeiger auf ein Unicodestring mit dem Namen der Domain oder der Arbeitsgruppe.

BufferType

Zeiger auf eine Variable vom Typ NETSETUP_JOIN_STATUS, welche den Typ des lpNameBuffer angibt.

Rückgabewerte

Die Funktion gibt einen Statuswert zurück, der einen Fehlerwert darstellt. Ist kein Fehler aufgetreten, so gibt die Funktion NERR_SUCCESS zurück. Eine erweiterte Auflistung der Fehlercodes finden Sie in der MSDN.

Hinweise

Diese Funktion der NetApi ist erst ab Windows 2000 verfügbar, auf Windows 9x ist sie nicht unterstützt.