NetGetJoinableOUs

Aus API-Wiki
Zur Navigation springenZur Suche springen

Diese Funktion ermittelt eine Liste von Organisationseinheiten(OU) in einem Actice Directory, in welcher der Aufrufer ein Computerkonto erstellen darf.

Declare Function NetGetJoinableOUs Lib "NetApi32" ( _
                            ByVal lpServername As Long, _
                            ByVal lpDomainname As Long,  _
                            ByVal lpAccount As Long, _
                            ByVal lpPassword As Long, _
                            ByRef OUCount as long, _
                            ByRef lpOUs As Long) As Long


Parameter

lpServername

Zeiger auf einen Unicodestring, der einen Computernamen enthält, welcher die Ermittlung durchführen soll.
Dieser Parameter darf NULL sein, dann wird der eigene Computer zur Ermittlung benutzt.
Übergabe mit StrPtr() empfohlen.

lpDomainname

Zeiger auf einen Unicodestring, der einen Domainname enthält.
Übergabe mit StrPtr() empfohlen.

lpAccount

Zeiger auf ein Unicodestring, der ein Benutzername enthält, welcher beim Zugriff auf den Domain Controller benutzt werden soll. Der Benutzername kann den NetBios Name der Domain und der NT Anmeldename sein (also "Domain\Username") oder ein UPN sein (also "Username@Domain.com").
Dieser Parameter darf NULL sein, dann wird der Benutzerkontext des Aufrufers verwendet.
Übergabe mit StrPtr() empfohlen.

lpPassword

Zeiger auf ein Unicodestring, der das passende Benutzerkennwort enthält.
Dieser Parameter muss NULL sein, wenn lpAccount ebenfalls NULL ist.
Übergabe mit StrPtr() empfohlen.

OUCount

Zeiger auf eine Variable vom Typ Long, in der die Anzahl von OUs gespeichert werden kann.

lpOUs

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 Array Zeigern auf Unicodestrings mit den OUs in der ein Computerkonto erstellt werden kann.


Rückgabe

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.


Hinweise

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