Funzione callback spGetCredentialsFn (ntsecpkg.h)

La funzione SpGetCredentials recupera le credenziali primarie e supplementari dall'oggetto utente.

Sintassi

SpGetCredentialsFn Spgetcredentialsfn;

NTSTATUS Spgetcredentialsfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [out] PSecBuffer Credentials
)
{...}

Parametri

[in] CredentialHandle

Handle per le credenziali da recuperare.

[out] Credentials

Puntatore a una struttura SecBuffer che riceve le credenziali.

Valore restituito

Se la funzione ha esito positivo, restituire STATUS_SUCCESS.

Se la funzione ha esito negativo, restituire un codice NTSTATUS che indica il motivo per cui non è riuscito. Di seguito sono elencati i motivi comuni per l'errore e i codici di errore restituiti dalla funzione.

Codice restituito	Descrizione
SEC_E_INSUFFICIENT_MEMORY	Memoria insufficiente per recuperare le credenziali.
SEC_E_INVALID_HANDLE	L'handle non è valido.

Commenti

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

Un puntatore alla funzione SpGetCredentials è 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

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize