Fonction DsRoleGetPrimaryDomainInformation (dsrole.h)
La fonction DsRoleGetPrimaryDomainInformation récupère les données d’état de l’ordinateur. Ces données incluent l’état de l’installation du service d’annuaire et les données de domaine.
Syntaxe
DWORD DsRoleGetPrimaryDomainInformation(
[in] LPCWSTR lpServer,
[in] DSROLE_PRIMARY_DOMAIN_INFO_LEVEL InfoLevel,
[out] PBYTE *Buffer
);
Paramètres
[in] lpServer
Pointeur vers une chaîne Unicode terminée par null qui contient le nom de l’ordinateur sur lequel appeler la fonction. Si ce paramètre a la valeur NULL, l’ordinateur local est utilisé.
[in] InfoLevel
Contient l’une des valeurs DSROLE_PRIMARY_DOMAIN_INFO_LEVEL qui spécifient le type de données à récupérer. Ce paramètre détermine également le format des données fournies dans Buffer.
[out] Buffer
Pointeur vers l’adresse d’une mémoire tampon qui reçoit les données demandées. Le format de ces données dépend de la valeur du paramètre InfoLevel .
L’appelant doit libérer cette mémoire quand elle n’est plus nécessaire en appelant DsRoleFreeMemory.
Valeur retournée
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour peut être l’une des valeurs suivantes.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | dsrole.h |
| Bibliothèque | Netapi32.lib |
| DLL | Netapi32.dll |
Voir aussi
DSROLE_PRIMARY_DOMAIN_INFO_BASIC