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 de 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 determinado de datos.
DS_ROLE_DOMAIN_OWNER
El servidor posee el 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 posee el esquema.
Valor devuelto
Si la función devuelve una lista de roles, el valor devuelto es 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.
Observaciones
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 Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista |
| servidor mínimo admitido | Windows Server 2008 |
| de la plataforma de destino de |
Windows |
| encabezado de |
ntdsapi.h |
| biblioteca de |
Ntdsapi.lib |
| DLL de |
Ntdsapi.dll |
Consulte también
controlador de dominio y funciones de administración de replicación