Función DsRemoveDsServerA (ntdsapi.h)
La función DsRemoveDsServer quita todos los seguimientos de un agente de servicio de directorio (DSA) del área global del servicio de directorio.
Sintaxis
NTDSAPI DWORD DsRemoveDsServerA(
[in] HANDLE hDs,
[in] LPSTR ServerDN,
[in, optional] LPSTR DomainDN,
[out, optional] BOOL *fLastDcInDomain,
[in] BOOL fCommit
);
Parámetros
[in] hDs
Contiene un identificador de servicio de directorio obtenido de la función DSBind o DSBindWithCred .
[in] ServerDN
Puntero a una cadena terminada en null que especifica el nombre distintivo completo del controlador de dominio que se va a quitar.
[in, optional] DomainDN
Puntero a una cadena terminada en null que especifica un dominio hospedado por ServerDN. Si este parámetro es NULL, no se realiza ninguna comprobación para asegurarse de que ServerDN es el último controlador de dominio en DomainDN.
[out, optional] fLastDcInDomain
Puntero a un valor booleano que recibe TRUE si ServerDN es el último controlador de dominio de DomainDN o FALSE en caso contrario. Este parámetro recibe FALSE si DomainDN es NULL.
[in] fCommit
Contiene un valor booleano que especifica si el controlador de dominio debe quitarse realmente. Si este parámetro es distinto de cero, se quita ServerDN . Si este parámetro es cero, se comprueba la existencia de ServerDN y se escribe fLastDcInDomain , pero no se quita el controlador de dominio.
Valor devuelto
Devuelve ERROR_SUCCESS si se ejecuta correctamente o un código de error Win32 o RPC si no se realiza correctamente. Los posibles códigos de error incluyen lo siguiente.
Comentarios
Nota
El encabezado ntdsapi.h define DsRemoveDsServer 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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 controlador de dominio y replicación