Funzione callback spGetCredentialsFn (ntsecpkg.h)

  • Articolo

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