funzione I_NetLogonControl2 (lmaccess.h)

Articolo
08/24/2023

La funzione I_NetLogonControl2 controlla vari aspetti del servizio Netlogon.

Sintassi

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

Parametri

[in, optional] ServerName

Nome del server remoto.

[in] FunctionCode

L'operazione da eseguire. Questo valore può essere uno dei seguenti.

Valore	Significato
NETLOGON_CONTROL_QUERY 1	Nessuna operazione. Restituisce solo le informazioni richieste.
NETLOGON_CONTROL_REPLICATE 2	Forza che il database di Gestione account di sicurezza (SAM) in un controller di dominio di backup (BDC) venga portato in sincronizzazione con la copia nel controller di dominio primario (PDC). Questa operazione non implica una sincronizzazione completa. Il servizio Netlogon replica eventuali differenze in sospeso, se possibile.
NETLOGON_CONTROL_SYNCHRONIZE 3	Forza un BDC per ottenere una nuova copia del database SAM dal pdC. Questa operazione esegue una sincronizzazione completa.
NETLOGON_CONTROL_PDC_REPLICATE 4	Forza un PDC a chiedere a ogni BDC di replicare ora.
NETLOGON_CONTROL_REDISCOVER 5	Forza un controller di dominio (DC) per individuare il controller di dominio attendibile specificato.
NETLOGON_CONTROL_TC_QUERY 6	Esegue query sul canale sicuro, richiedendo un aggiornamento dello stato sull'ultimo utilizzo.
NETLOGON_CONTROL_TC_VERIFY 10	Verifica lo stato corrente del canale sicuro del dominio attendibile specificato. Se lo stato indica l'esito positivo, il controller di dominio viene eseguito il ping. Se lo stato o il ping indica l'errore, viene ritrovato un nuovo controller di dominio attendibile.
NETLOGON_CONTROL_CHANGE_PASSWORD 9	Forza una modifica della password in un canale sicuro in un dominio attendibile.
NETLOGON_CONTROL_FORCE_DNS_REG 11	Forza il controller di dominio a registrare nuovamente tutti i record DNS. Il parametro QueryLevel deve essere impostato su 1.
NETLOGON_CONTROL_QUERY_DNS_REG 12	Genera una query che richiede lo stato degli aggiornamenti DNS eseguiti dal servizio Netlogon. Se si sono verificati errori di registrazione o registrazione DNS nell'ultimo aggiornamento, il risultato è negativo. Il parametro QueryLevel deve essere impostato su 1.

[in] QueryLevel

Indica quali informazioni devono essere restituite dal servizio Netlogon. Questo valore può essere una delle strutture seguenti.

NETLOGON_INFO_1 (1)

NETLOGON_INFO_2 (2)

NETLOGON_INFO_3 (3)

NETLOGON_INFO_4 (4)

[in] Data

Trasporta i dati di input che dipendono dal valore specificato nel parametro FunctionCode . I codici di funzione NETLOGON_CONTROL_REDISCOVER e NETLOGON_CONTROL_TC_QUERY specificano il nome di dominio attendibile (il tipo di dati è LPWSTR *).

[out] Buffer

Restituisce un puntatore a un buffer contenente le informazioni richieste nella struttura passata nel parametro QueryLevel .

Il buffer deve essere liberato usando NetApiBufferFree.

Valore restituito

Il metodo restituisce 0x00000000 (NERR_Success) in caso di esito positivo; in caso contrario, restituisce un codice di errore diverso da zero definito in Lmerr.h o Winerror.h. NET_API_STATUS codici di errore iniziano con il valore 0x00000834. Per altre informazioni sui codici di errore di gestione della rete, vedere Network_Management_Error_Codes. La tabella seguente descrive i valori restituiti possibili.

Codice/valore restituito	Descrizione
NERR_Success 0x00000000	Chiamata al metodo completata senza errori.
ERROR_ACCESS_DENIED 0x00000005	La convalida di accesso nel chiamante restituisce false. Accesso negato.
ERROR_NOT_ENOUGH_MEMORY 0x00000008	L'archiviazione non è sufficiente per elaborare questo comando.
ERROR_NOT_SUPPORTED 0x00000032	Un codice di funzione non è valido nel server specificato. Ad esempio, NETLOGON_CONTROL_REPLICATE potrebbe essere stato passato a un controller di dominio primario (PDC).
ERROR_INVALID_PARAMETER 0x00000057	Un parametro non è corretto.
ERROR_INVALID_LEVEL 0x0000007C	Il livello di chiamata della query non è corretto.
ERROR_SERVICE_NOT_ACTIVE 0x000004261210121	Il servizio non è stato avviato.
ERROR_INVALID_COMPUTERNAME 0x000004BA	Il formato del nome del computer specificato non è valido.
ERROR_NO_LOGON_SERVERS 0x0000051F	Attualmente non sono disponibili server di accesso per il servizio della richiesta di accesso.
ERROR_INVALID_DOMAIN_ROLE 0x0000054A	La modifica della password per un account di attendibilità interdominio è stata tentata in un controller di dominio di backup (BDC). Questa operazione è consentita solo per il pdc del dominio.
ERROR_NO_SUCH_DOMAIN 0x0000054B	il dominio specificato non esiste o non è stato possibile contattarlo.
NERR_UserNotFound 0x000008AD	Impossibile trovare il nome utente.

Commenti

Questa funzione può essere usata per richiedere che un cluster big data assicuri che la copia del database SAM sia aggiornata. Può anche essere usato per determinare se un cluster big data ha attualmente un canale sicuro aperto al PDC.