Funzione LogonUserW (winbase.h)

La funzione LogonUser tenta di accedere a un utente nel computer locale. Il computer locale è il computer da cui è stato chiamato LogonUser. Non è possibile usare LogonUser per accedere a un computer remoto. Specificare l'utente con un nome utente e un dominio e autenticare'utente con una password testo non crittografato. Se la funzione ha esito positivo, si riceve un handle a un token che rappresenta l'utente connesso. È quindi possibile usare questo handle di token per rappresentare l'utente specificato o, nella maggior parte dei casi, per creare un processo eseguito nel contesto dell'utente specificato.

Sintassi

BOOL LogonUserW(
  [in]           LPCWSTR lpszUsername,
  [in, optional] LPCWSTR lpszDomain,
  [in, optional] LPCWSTR lpszPassword,
  [in]           DWORD   dwLogonType,
  [in]           DWORD   dwLogonProvider,
  [out]          PHANDLE phToken
);

Parametri

[in] lpszUsername

Puntatore a una stringa con terminazione Null che specifica il nome dell'utente. Si tratta del nome dell'account utente a cui accedere. Se si usa il formato nome entità utente (UPN), User@DNSDomainName, il parametro lpszDomain deve essere NULL.

[in, optional] lpszDomain

Puntatore a una stringa con terminazione Null che specifica il nome del dominio o del server il cui database account contiene l'account lpszUsername. Se questo parametro è NULL, il nome utente deve essere specificato in formato UPN. Se questo parametro è ".", la funzione convalida l'account usando solo il database dell'account locale.

[in, optional] lpszPassword

Puntatore a una stringa con terminazione Null che specifica la password in testo non crittografato per l'account utente specificato da lpszUsername. Al termine dell'uso della password, cancellare la password dalla memoria chiamando la funzione secureZeroMemory . Per altre informazioni sulla protezione delle password, vedere Gestione delle password.

[in] dwLogonType

Tipo di operazione di accesso da eseguire. Questo parametro può essere uno dei valori seguenti, definiti in Winbase.h.

[in] dwLogonProvider

Specifica il provider di accesso. Questo parametro può essere uno dei valori seguenti.

[out] phToken

Puntatore a una variabile handle che riceve un handle a un token che rappresenta l'utente specificato.

È possibile usare l'handle restituito nelle chiamate alla funzione ImpersonateLoggedOnUser.

Nella maggior parte dei casi, l'handle restituito è un token primario che è possibile usare nelle chiamate alla funzione CreateProcessAsUser . Tuttavia, se si specifica il flag di LOGON32_LOGON_NETWORK, LogonUser restituisce un token di rappresentazione che non è possibile usare in CreateProcessAsUser a meno che non si chiami DuplicateTokenEx per convertirlo in un token primario.

Quando questo handle non è più necessario, chiuderlo chiamando la funzione CloseHandle.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce un valore diverso da zero.

Se la funzione ha esito negativo, restituisce zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

Il tipo di accesso LOGON32_LOGON_NETWORK è più veloce, ma presenta le limitazioni seguenti:

• La funzione restituisce un token di rappresentazione , non un token primario. Non è possibile usare questo token direttamente nella funzione CreateProcessAsUser. Tuttavia, è possibile chiamare la funzione DuplicateTokenEx per convertire il token in un token primario e quindi usarlo in CreateProcessAsUser.
• Se si converte il token in un token primario e lo si usa in CreateProcessAsUser per avviare un processo, il nuovo processo non può accedere ad altre risorse di rete, ad esempio server remoti o stampanti, tramite il redirector. Un'eccezione è che se la risorsa di rete non è controllata dall'accesso, il nuovo processo sarà in grado di accedervi.

Il privilegio SE_TCB_NAME non è necessario per questa funzione, a meno che non si esegua l'accesso a un account Passport.

L'account specificato da lpszUsername, deve avere i diritti dell'account necessari. Ad esempio, per accedere a un utente con il flag LOGON32_LOGON_INTERACTIVE, l'utente (o un gruppo a cui appartiene l'utente) deve avere il diritto di SE_INTERACTIVE_LOGON_NAME account. Per un elenco dei diritti dell'account che influiscono sulle varie operazioni di accesso, vedere Costanti diritti account.

Un utente viene considerato connesso se esiste almeno un token. Se si chiama CreateProcessAsUser e quindi si chiude il token, il sistema considera l'utente ancora connesso fino al termine del processo (e di tutti i processi figlio).

Se la chiamata LogonUser ha esito positivo, il sistema notifica ai provider di rete che l'accesso si è verificato chiamando NPLogonNotify funzione del punto di ingresso del provider.

Esempi

È possibile generare un token LocalService usando il codice seguente.

LogonUser(L"LocalService", L"NT AUTHORITY", NULL, LOGON32_LOGON_SERVICE, LOGON32_PROVIDER_DEFAULT, &hToken)

Fabbisogno

Vedere anche

di controllo di accesso client/server

funzioni di controllo di accesso client/server

CloseHandle

CreateProcessAsUser

DuplicateTokenEx

ImpersonateLoggedOnUser