NetGetJoinableOUs-Funktion (lmjoin.h)

Artikel
08/24/2023

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
ERROR_NOT_ENOUGH_MEMORY	Für die Verarbeitung dieses Befehls ist nicht genügend Speicherplatz verfügbar.
NERR_DefaultJoinRequired	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

Weitere Informationen

NetGetJoinInformation

Netzwerkverwaltungsfunktionen

Übersicht über die Netzwerkverwaltung

Share via