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 de 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 de DomainDN.
[out, optional] fLastDcInDomain
Puntero a un valor booleano que recibe TRUE si serverDN es el último controlador de dominio de DomainDN o FALSE de lo contrario. Este parámetro recibe FALSE si DomainDN es NULL.
[in] fCommit
Contiene un valor booleano que especifica si realmente se debe quitar el controlador de dominio. Si este parámetro no es 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 códigos de error posibles incluyen lo siguiente.
Observaciones
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 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