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" ( _ ...)
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.