NetGetDCName

Aus API-Wiki
Version vom 26. Februar 2007, 23:00 Uhr von Kai (Diskussion | Beiträge) (Die Seite wurde neu angelegt: Diese Funktion ''ermittelt'' den Primary Domain Controller (PDC) einer Windows Domain. <pre> Declare Function NetGetDCName Lib "NetApi32" ( _ ...)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Zur Navigation springenZur Suche springen

Diese Funktion ermittelt den Primary Domain Controller (PDC) einer Windows Domain.

Declare Function NetGetDCName Lib "NetApi32" ( _
                            ByVal lpServername As Long, _
                            ByVal lpDomainname As Long,  _
                            ByRef lpBuffer As Long) As Long


Parameter:

lpServername [Übergabe]

Zeiger auf einen Unicodestring, der einen Computernamen enthält, welcher die Ermittlung durchführen soll. Unter Windows NT muss der Name mit dem Präfix '\\' beginnen.
Dieser Parameter darf NULL sein, dann wird der eigene Computer zur Ermittlung benutzt.
Übergabe mit StrPtr() empfohlen.

lpDomainname [Übergabe]

Zeiger auf einen Unicodestring, der einen Domainname enthält. Dieser Parameter darf NULL sein, dann wird der PDC der primären Domain ermittelt.
Übergabe mit StrPtr() empfohlen.

lpBuffer [Übergabe]

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 Unicodestring mit dem Computernamen des PDC, beginnend mit '\\'.


Rückgabewert(e):

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


Sonstige Hinweise:

Diese Funktion der NetApi ist nur auf NT basierten Betriebssystemen verfügbar, auf Windows 9x ist sie nicht unterstützt.