función I_NetLogonControl2 (lmaccess.h)

La función I_NetLogonControl2 controla varios aspectos del servicio Netlogon.

Syntax

NET_API_STATUS NET_API_FUNCTION I_NetLogonControl2(
  [in, optional] LPCWSTR ServerName,
  [in]           DWORD   FunctionCode,
  [in]           DWORD   QueryLevel,
  [in]           LPBYTE  Data,
  [out]          LPBYTE  *Buffer
);

Parámetros

[in, optional] ServerName

Nombre del servidor remoto.

[in] FunctionCode

Operación que se va a realizar. Este valor puede ser uno de los siguientes.

Importancia	Meaning
NETLOGON_CONTROL_QUERY 1	Sin operación. Devuelve solo la información solicitada.
NETLOGON_CONTROL_REPLICATE 2	Obliga a que la base de datos del administrador de cuentas de seguridad (SAM) de un controlador de dominio de copia de seguridad (BDC) se sincronice con la copia en el controlador de dominio principal (PDC). Esta operación no implica una sincronización completa. El servicio Netlogon replica las diferencias pendientes si es posible.
NETLOGON_CONTROL_SYNCHRONIZE 3	Obliga a un BDC a obtener una nueva copia de la base de datos SAM del PDC. Esta operación realiza una sincronización completa.
NETLOGON_CONTROL_PDC_REPLICATE 4	Obliga a un PDC a pedir que cada BDC se replique ahora.
NETLOGON_CONTROL_REDISCOVER 5	Obliga a un controlador de dominio (DC) a redescubrir el controlador de dominio de confianza especificado.
NETLOGON_CONTROL_TC_QUERY 6	Consulta el canal seguro, solicitando una actualización de estado sobre su último uso.
NETLOGON_CONTROL_TC_VERIFY 10	Comprueba el estado actual del canal seguro de dominio de confianza especificado. Si el estado indica que se ha realizado correctamente, se hace ping al controlador de dominio. Si el estado o el ping indican un error, se vuelve a detectar un nuevo controlador de dominio de confianza.
NETLOGON_CONTROL_CHANGE_PASSWORD 9	Fuerza un cambio de contraseña en un canal seguro a un dominio de confianza.
NETLOGON_CONTROL_FORCE_DNS_REG 11	Obliga al controlador de dominio a volver a registrar todos sus registros DNS. El parámetro QueryLevel debe establecerse en 1.
NETLOGON_CONTROL_QUERY_DNS_REG 12	Emite una consulta que solicita el estado de las actualizaciones de DNS realizadas por el servicio Netlogon. Si se produjo algún error de registro o registro dns en la última actualización, el resultado es negativo. El parámetro QueryLevel debe establecerse en 1.

[in] QueryLevel

Indica qué información se debe devolver desde el servicio Netlogon. Este valor puede ser cualquiera de las estructuras siguientes.

NETLOGON_INFO_1 (1)

NETLOGON_INFO_2 (2)

NETLOGON_INFO_3 (3)

NETLOGON_INFO_4 (4)

[in] Data

Incluye datos de entrada que dependen del valor especificado en el parámetro FunctionCode . Los códigos de función NETLOGON_CONTROL_REDISCOVER y NETLOGON_CONTROL_TC_QUERY especifican el nombre de dominio de confianza (el tipo de datos es LPWSTR *).

[out] Buffer

Devuelve un puntero a un búfer que contiene la información solicitada en la estructura pasada en el parámetro QueryLevel .

El búfer debe liberarse mediante NetApiBufferFree.

Valor devuelto

El método devuelve 0x00000000 (NERR_Success) si se realiza correctamente; de lo contrario, devuelve un código de error distinto de cero definido en Lmerr.h o Winerror.h. NET_API_STATUS códigos de error comienzan con el valor 0x00000834. Para obtener más información sobre los códigos de error de administración de red, consulte Network_Management_Error_Codes. En la tabla siguiente se describen los posibles valores devueltos.

Código y valor devueltos	Description
NERR_Success 0x00000000	La llamada al método se completó sin errores.
ERROR_ACCESS_DENIED 0x00000005	La validación de acceso en el autor de la llamada devuelve false. Acceso denegado.
ERROR_NOT_ENOUGH_MEMORY 0x00000008	No hay suficiente almacenamiento disponible para procesar este comando.
ERROR_NOT_SUPPORTED 0x00000032	Un código de función no es válido en el servidor especificado. Por ejemplo, es posible que NETLOGON_CONTROL_REPLICATE se hayan pasado a un controlador de dominio principal (PDC).
ERROR_INVALID_PARAMETER 0x00000057	Un parámetro es incorrecto.
ERROR_INVALID_LEVEL 0x0000007C	El nivel de llamada de consulta no es correcto.
ERROR_SERVICE_NOT_ACTIVE 0x000004261210121	No se ha iniciado el servicio.
ERROR_INVALID_COMPUTERNAME 0x000004BA	El formato del nombre de equipo especificado no es válido.
ERROR_NO_LOGON_SERVERS 0x0000051F	Actualmente no hay ningún servidor de inicio de sesión disponible para atender la solicitud de inicio de sesión.
ERROR_INVALID_DOMAIN_ROLE 0x0000054A	Se intentó cambiar la contraseña de una cuenta de confianza entre dominios en un controlador de dominio de copia de seguridad (BDC). Esta operación solo se permite para el PDC del dominio.
ERROR_NO_SUCH_DOMAIN 0x0000054B	El dominio especificado no existe o no se pudo ponerse en contacto con él.
NERR_UserNotFound 0x000008AD	No se encontró el nombre de usuario.

Observaciones

Esta función se puede usar para solicitar que un BDC asegúrese de que su copia de la base de datos SAM se lleva up-to-date. También se puede usar para determinar si un BDC tiene actualmente un canal seguro abierto al PDC.

Requisitos

Requirement	Importancia
de la plataforma de destino de	Windows
Header	lmaccess.h
Library	Netapi32.lib
DLL de	Netapi32.dll

Consulte también

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-11-26