Función DsRoleGetPrimaryDomainInformation (dsrole.h)

La función DsRoleGetPrimaryDomainInformation recupera los datos de estado del equipo. Estos datos incluyen el estado de la instalación del servicio de directorio y los datos de dominio.

Sintaxis

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

Parámetros

[in] lpServer

Puntero a una cadena Unicode terminada en null que contiene el nombre del equipo en el que se va a llamar a la función. Si este parámetro es NULL, se usa el equipo local.

[in] InfoLevel

Contiene uno de los valores de DSROLE_PRIMARY_DOMAIN_INFO_LEVEL que especifican el tipo de datos que se van a recuperar. Este parámetro también determina el formato de los datos proporcionados en buffer.

[out] Buffer

Puntero a la dirección de un búfer que recibe los datos solicitados. El formato de estos datos depende del valor del parámetro InfoLevel .

El autor de la llamada debe liberar esta memoria cuando ya no sea necesaria llamando a DsRoleFreeMemory.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto se ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes valores.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	dsrole.h
Library	Netapi32.lib
Archivo DLL	Netapi32.dll

Consulte también

DSROLE_OPERATION_STATE_INFO

DSROLE_PRIMARY_DOMAIN_INFO_BASIC

DSROLE_UPGRADE_STATUS_INFO

Funciones del servicio de directorio

DsRoleFreeMemory