NetGetJoinableOUs-Funktion (lmjoin.h)
Die NetGetJoinableOUs-Funktion ruft eine Liste der Organisationseinheiten (OUs) ab, in denen ein Computerkonto erstellt werden kann.
Syntax
NET_API_STATUS NET_API_FUNCTION NetGetJoinableOUs(
[in] LPCWSTR lpServer,
[in] LPCWSTR lpDomain,
[in] LPCWSTR lpAccount,
[in] LPCWSTR lpPassword,
[out] DWORD *OUCount,
[out] LPWSTR **OUs
);
Parameter
[in] lpServer
Zeiger auf eine konstante Zeichenfolge, die den DNS- oder NetBIOS-Namen des Computers angibt, auf dem die Funktion aufgerufen werden soll. Wenn dieser Parameter NULL ist, wird der lokale Computer verwendet.
[in] lpDomain
Zeiger auf eine konstante Zeichenfolge, die den Namen der Domäne angibt, für die die Liste der Organisationseinheiten abgerufen werden soll, die verknüpft werden können.
[in] lpAccount
Zeiger auf eine konstante Zeichenfolge, die den Kontonamen angibt, der beim Herstellen einer Verbindung mit dem Domänencontroller verwendet werden soll. Die Zeichenfolge muss entweder einen NetBIOS-Domänennamen und ein Benutzerkonto (z. B. "REDMOND\user") oder den Benutzerprinzipalnamen (UPN) des Benutzers in Form eines Anmeldenamens im Internetformat (z. B. "someone@example.com") angeben. Wenn dieser Parameter NULL ist, wird der Kontext des Aufrufers verwendet.
[in] lpPassword
Wenn der parameter lpAccount einen Kontonamen angibt, muss dieser Parameter auf das Kennwort verweisen, das beim Herstellen einer Verbindung mit dem Domänencontroller verwendet werden soll. Andernfalls muss dieser Parameter NULL sein.
[out] OUCount
Empfängt die Anzahl der Organisationseinheiten, die in der Liste der verknüpften Organisationseinheiten zurückgegeben werden.
[out] OUs
Zeiger auf ein Array, das die Liste der verknüpften Organisationseinheiten empfängt. Dieses Array wird vom System zugeordnet und muss mithilfe eines einzelnen Aufrufs der NetApiBufferFree-Funktion freigegeben werden. Weitere Informationen finden Sie unter Netzwerkverwaltungsfunktionspuffer und Netzwerkverwaltungsfunktionspufferlängen.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert NERR_Success.
Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Fehlercodes oder einer der Systemfehlercodes sein.
| Rückgabecode | Beschreibung |
|---|---|
|
Für die Verarbeitung dieses Befehls ist nicht genügend Speicherplatz verfügbar. |
|
Der Zieldomänencontroller unterstützt das Erstellen von Computerkonten in Organisationseinheiten nicht. |
Hinweise
Für die erfolgreiche Ausführung der NetGetJoinableOUs-Funktion ist keine spezielle Gruppenmitgliedschaft erforderlich.
Weitere Informationen zu Organisationseinheiten finden Sie unter Verwalten von Benutzern in der Active Directory-Dokumentation.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | lmjoin.h (lm.h einschließen) |
| Bibliothek | Netapi32.lib |
| DLL | Netapi32.dll |