Funzione DsListRolesA (ntdsapi.h)
La funzione DsListRoles
Sintassi
NTDSAPI DWORD DsListRolesA(
[in] HANDLE hDs,
[out] PDS_NAME_RESULTA *ppRoles
);
Parametri
[in] hDs
Contiene un handle del servizio directory ottenuto dalla funzione DSBind o DSBindWithCred.
[out] ppRoles
Puntatore a una variabile che riceve un puntatore a una struttura DS_NAME_RESULT contenente i ruoli riconosciuti dal server. La struttura restituita deve essere deallocata usando DsFreeNameResult.
Gli indici della matrice nella struttura DS_NAME_RESULT indicano quali dati sono contenuti da ogni elemento della matrice. È possibile utilizzare le costanti seguenti per specificare l'indice desiderato per una determinata parte di dati.
DS_ROLE_DOMAIN_OWNER
Il server è proprietario del dominio.
DS_ROLE_INFRASTRUCTURE_OWNER
Il server è proprietario dell'infrastruttura.
DS_ROLE_PDC_OWNER
Il server possiede il PDC.
DS_ROLE_RID_OWNER
Il server possiede il rid.
DS_ROLE_SCHEMA_OWNER
Il server è proprietario dello schema.
Valore restituito
Se la funzione restituisce un elenco di ruoli, il valore restituito è NO_ERROR.
Se la funzione ha esito negativo, il valore restituito può essere uno dei codici di errore seguenti.
Gli errori di conversione dei nomi singoli vengono segnalati nella struttura di DS_NAME_RESULT restituita.
Osservazioni
Nota
L'intestazione ntdsapi.h definisce DsListRoles come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| server minimo supportato | Windows Server 2008 |
| piattaforma di destinazione | Finestre |
| intestazione |
ntdsapi.h |
| libreria |
Ntdsapi.lib |
| dll | Ntdsapi.dll |