Compartir a través de


Función DsListRolesA (ntdsapi.h)

La función DsListRoles enumera los roles reconocidos por el servidor.

Sintaxis

NTDSAPI DWORD DsListRolesA(
  [in]  HANDLE           hDs,
  [out] PDS_NAME_RESULTA *ppRoles
);

Parámetros

[in] hDs

Contiene un identificador de servicio de directorio obtenido de la función DSBind o DSBindWithCred .

[out] ppRoles

Puntero a una variable que recibe un puntero a una estructura de DS_NAME_RESULT que contiene los roles que reconoce el servidor. La estructura devuelta debe desasignarse mediante DsFreeNameResult.

Los índices de la matriz de la estructura DS_NAME_RESULT indican qué datos contienen cada elemento de matriz. Las constantes siguientes se pueden usar para especificar el índice deseado para un fragmento de datos determinado.

DS_ROLE_DOMAIN_OWNER

El servidor es el propietario del dominio.

DS_ROLE_INFRASTRUCTURE_OWNER

El servidor posee la infraestructura.

DS_ROLE_PDC_OWNER

El servidor posee el PDC.

DS_ROLE_RID_OWNER

El servidor posee el RID.

DS_ROLE_SCHEMA_OWNER

El servidor es el propietario del esquema.

Valor devuelto

Si la función devuelve una lista de roles, el valor devuelto se NO_ERROR.

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

Los errores de conversión de nombres individuales se notifican en la estructura de DS_NAME_RESULT devuelta.

Comentarios

Nota

El encabezado ntdsapi.h define DsListRoles como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

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

Consulte también

DS_NAME_RESULT

Funciones de administración de replicación y controlador de dominio

DsFreeNameResult