Funzione di callback spGetUserInfoFn (ntsecpkg.h)

  • Articolo

La funzione SpGetUserInfo recupera informazioni su una sessione di accesso.

Sintassi

SpGetUserInfoFn Spgetuserinfofn;

NTSTATUS Spgetuserinfofn(
  [in]  PLUID LogonId,
  [in]  ULONG Flags,
  [out] PSecurityUserData *UserData
)
{...}

Parametri

[in] LogonId

Puntatore a un LUID contenente la sessione di accesso per cui recuperare le informazioni.

[in] Flags

Specifica la lunghezza accettabile del nome di dominio come uno dei valori seguenti.

Valore Significato
NO_LONG_NAMES
 Il nome di dominio restituito non può essere superiore a 15 caratteri.
UNDERSTANDS_LONG_NAMES
 Il nome di dominio restituito può essere più lungo di 15 caratteri.

[out] UserData

Puntatore a un puntatore a una struttura SecurityUserData . Se la chiamata di funzione ha esito positivo, le informazioni utente vengono restituite in questa struttura. Il pacchetto di sicurezza deve allocare la memoria per questa struttura nello spazio indirizzi del chiamante. Il chiamante è responsabile della liberazione del buffer chiamando la funzione FreeContextBuffer .

Valore restituito

Se la funzione ha esito positivo, restituire STATUS_SUCCESS.

Se la funzione ha esito negativo, restituisce un codice NTSTATUS che indica il motivo per cui non è riuscito.

Commenti

Il valore Flags NO_LONG_NAMES fornisce compatibilità con Microsoft NTLM.

SSP/APs deve implementare la funzione SpGetUserInfo ; tuttavia, il nome effettivo assegnato all'implementazione è fino allo sviluppatore.

Un puntatore alla funzione SpGetUserInfo è disponibile nella struttura SECPKG_FUNCTION_TABLEricevuta dalla funzione SpLsaModeInitialize .

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ntsecpkg.h

Vedi anche

FreeContextBuffer

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize