Funzione DsRoleGetPrimaryDomainInformation (dsrole.h)

La funzione DsRoleGetPrimaryDomainInformation recupera i dati sullo stato per il computer. Questi dati includono lo stato dell'installazione e dei dati del dominio del servizio directory.

Sintassi

DWORD DsRoleGetPrimaryDomainInformation(
  [in]  LPCWSTR                          lpServer,
  [in]  DSROLE_PRIMARY_DOMAIN_INFO_LEVEL InfoLevel,
  [out] PBYTE                            *Buffer
);

Parametri

[in] lpServer

Puntatore alla stringa Unicode con terminazione Null contenente il nome del computer in cui chiamare la funzione. Se questo parametro è NULL, viene utilizzato il computer locale.

[in] InfoLevel

Contiene uno dei valori DSROLE_PRIMARY_DOMAIN_INFO_LEVEL che specificano il tipo di dati da recuperare. Questo parametro determina anche il formato dei dati forniti in Buffer.

[out] Buffer

Puntatore all'indirizzo di un buffer che riceve i dati richiesti. Il formato di questi dati dipende dal valore del parametro InfoLevel .

Il chiamante deve liberare questa memoria quando non è più necessaria chiamando DsRoleFreeMemory.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	dsrole.h
Libreria	Netapi32.lib
DLL	Netapi32.dll

Vedi anche

DSROLE_OPERATION_STATE_INFO

DSROLE_PRIMARY_DOMAIN_INFO_BASIC

DSROLE_UPGRADE_STATUS_INFO

Funzioni del servizio directory

DsRoleFreeMemory