Funzione NetGetJoinableOUs (lmjoin.h)

Articolo
03/14/2023

La funzione NetGetJoinableOUs recupera un elenco di unità organizzative in cui è possibile creare un account computer.

Sintassi

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
);

Parametri

[in] lpServer

Puntatore a una stringa costante che specifica il nome DNS o NetBIOS del computer in cui chiamare la funzione. Se questo parametro è NULL, viene usato il computer locale.

[in] lpDomain

Puntatore a una stringa costante che specifica il nome del dominio per cui recuperare l'elenco di unità organizzative che possono essere unite.

[in] lpAccount

Puntatore a una stringa costante che specifica il nome dell'account da usare durante la connessione al controller di dominio. La stringa deve specificare un nome NetBIOS di dominio e un account utente ,ad esempio "REDMOND\user") o il nome entità utente (UPN) dell'utente sotto forma di un nome di accesso in stile Internet ,ad esempio "someone@example.com"). Se questo parametro è NULL, viene usato il contesto del chiamante.

[in] lpPassword

Se il parametro lpAccount specifica un nome account, questo parametro deve puntare alla password da usare durante la connessione al controller di dominio. In caso contrario, questo parametro deve essere NULL.

[out] OUCount

Riceve il conteggio delle unità organizzative restituite nell'elenco delle unità organizzative joinable.

[out] OUs

Puntatore a una matrice che riceve l'elenco di unità organizzative joinable. Questa matrice viene allocata dal sistema e deve essere liberata usando una singola chiamata alla funzione NetApiBufferFree . Per altre informazioni, vedere Buffer delle funzioni di gestione della rete e lunghezze del buffer delle funzioni di gestione della rete.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NERR_Success.

Se la funzione ha esito negativo, il valore restituito può essere uno dei codici di errore seguenti o uno dei codici di errore di sistema.

Codice restituito	Descrizione
ERROR_NOT_ENOUGH_MEMORY	L'archiviazione non è sufficiente per elaborare questo comando.
NERR_DefaultJoinRequired	Il controller di dominio di destinazione non supporta la creazione di account computer nelle unità organizzative.

Commenti

Non è necessaria alcuna appartenenza speciale al gruppo per eseguire correttamente la funzione NetGetJoinableOUs .

Per altre informazioni sulle unità organizzative, vedere Gestione degli utenti nella documentazione di Active Directory.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	lmjoin.h (include Lm.h)
Libreria	Netapi32.lib
DLL	Netapi32.dll

Vedi anche

NetGetJoinInformation

Funzioni di gestione della rete

Panoramica sulla gestione della rete

Condividi tramite