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
Funciones de administración de replicación y controlador de dominio