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_PRIMARY_DOMAIN_INFO_BASIC