Funzione DsGetDomainControllerInfoA (ntdsapi.h)

Articolo
11/20/2024

La funzione DsGetDomainControllerInfo recupera i dati sui controller di dominio in un dominio.

Sintassi

NTDSAPI DWORD DsGetDomainControllerInfoA(
  [in]  HANDLE hDs,
  [in]  LPCSTR DomainName,
  [in]  DWORD  InfoLevel,
  [out] DWORD  *pcOut,
  [out] VOID   **ppInfo
);

Parametri

[in] hDs

Contiene un handle del servizio directory ottenuto dalla funzione DSBind o DSBindWithCred.

[in] DomainName

Puntatore a una stringa con terminazione Null che specifica il nome di dominio.

[in] InfoLevel

Contiene un valore che indica la versione della struttura DS_DOMAIN_CONTROLLER_INFO da restituire. Può trattarsi di uno dei valori seguenti.

1

La funzione fornisce i dati di dominio nel formato della struttura DS_DOMAIN_CONTROLLER_INFO_1.

2

La funzione fornisce i dati di dominio nel formato della struttura DS_DOMAIN_CONTROLLER_INFO_2.

3

La funzione fornisce i dati di dominio nel formato della struttura DS_DOMAIN_CONTROLLER_INFO_3.

[out] pcOut

Puntatore a una variabile DWORD che riceve il numero di elementi restituiti nella matrice ppInfo.

[out] ppInfo

Puntatore a una variabile puntatore che riceve una matrice di strutture DS_DOMAIN_CONTROLLER_INFO_*. Il tipo di strutture in questa matrice viene definito dal parametro InfoLevel. Il chiamante deve liberare questa matrice, quando non è più necessaria, usando la funzione DsFreeDomainControllerInfo.

Valore restituito

Se la funzione restituisce i dati del controller di dominio, il valore restituito è ERROR_SUCCESS. Se il chiamante non dispone dei privilegi per accedere agli oggetti server, il valore restituito è ERROR_SUCCESS, ma le strutture DS_DOMAIN_CONTROLLER_INFO potrebbero essere vuote.

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

Osservazioni

Nota

L'intestazione ntdsapi.h definisce DsGetDomainControllerInfo 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