función I_NetLogonControl2 (lmaccess.h)

Artículo
03/09/2023

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

Sintaxis

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

La operación que se va a realizar. Puede tomar uno de los valores siguientes.

Value	Significado
NETLOGON_CONTROL_QUERY 1	No hay ninguna 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 y solicita 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 ha producido 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

Lleva los 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 por 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 o valor devuelto	Descripción
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. Se denegó el acceso.
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	El servicio no se ha iniciado.
ERROR_INVALID_COMPUTERNAME 0x000004BA	El formato del nombre de equipo especificado no es válido.
ERROR_NO_LOGON_SERVERS 0x0000051F	Actualmente no hay servidores de inicio de sesión disponibles 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 establecer contacto con él.
NERR_UserNotFound 0x000008AD	No se encontró el nombre de usuario.

Comentarios

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