NetGetJoinableOUs, fonction (lmjoin.h)

  • Article

La fonction NetGetJoinableOUs récupère une liste d’unités d’organisation (UO) dans lesquelles un compte d’ordinateur peut être créé.

Syntaxe

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

Paramètres

[in] lpServer

Pointeur vers une chaîne constante qui spécifie le nom DNS ou NetBIOS de l’ordinateur sur lequel appeler la fonction. Si ce paramètre a la valeur NULL, l’ordinateur local est utilisé.

[in] lpDomain

Pointeur vers une chaîne constante qui spécifie le nom du domaine pour lequel récupérer la liste des unités d’organisation pouvant être jointes.

[in] lpAccount

Pointeur vers une chaîne constante qui spécifie le nom de compte à utiliser lors de la connexion au contrôleur de domaine. La chaîne doit spécifier un nom netBIOS de domaine et un compte d’utilisateur (par exemple, « REDMOND\user ») ou le nom d’utilisateur principal (UPN) de l’utilisateur sous la forme d’un nom de connexion de style Internet (par exemple, «someone@example.com »). Si ce paramètre a la valeur NULL, le contexte de l’appelant est utilisé.

[in] lpPassword

Si le paramètre lpAccount spécifie un nom de compte, ce paramètre doit pointer vers le mot de passe à utiliser lors de la connexion au contrôleur de domaine. Sinon, ce paramètre doit être NULL.

[out] OUCount

Reçoit le nombre d’unités d’organisation retournées dans la liste des unités d’organisation joignables.

[out] OUs

Pointeur vers un tableau qui reçoit la liste des unités d’organisation joignables. Ce tableau est alloué par le système et doit être libéré à l’aide d’un seul appel à la fonction NetApiBufferFree . Pour plus d’informations, consultez Mémoires tampons de fonction de gestionréseau et Longueurs de mémoire tampon des fonctions de gestion réseau.

Valeur retournée

Si la fonction réussit, la valeur de retour est NERR_Success.

Si la fonction échoue, la valeur de retour peut être l’un des codes d’erreur suivants ou l’un des codes d’erreur système.

Code de retour Description
ERROR_NOT_ENOUGH_MEMORY
 L’espace de stockage disponible est insuffisant pour traiter cette commande.
NERR_DefaultJoinRequired
 Le contrôleur de domaine de destination ne prend pas en charge la création de comptes d’ordinateur dans les unités d’organisation.

Notes

Aucune appartenance à un groupe spécial n’est requise pour exécuter correctement la fonction NetGetJoinableOUs .

Pour plus d’informations sur les unités organisationnelles, consultez Gestion des utilisateurs dans la documentation Active Directory.

Spécifications

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête lmjoin.h (include Lm.h)
Bibliothèque Netapi32.lib
DLL Netapi32.dll

Voir aussi

NetGetJoinInformation

Fonctions de gestion réseau

Vue d’ensemble de la gestion du réseau