Funzione di callback spGetContextTokenFn (ntsecpkg.h)

  • Articolo

Ottiene il token da rappresentare. La funzione SpGetContextToken viene usata dalla funzione SSPI ImpersonateSecurityContext per ottenere il token da rappresentare.

Sintassi

SpGetContextTokenFn Spgetcontexttokenfn;

NTSTATUS Spgetcontexttokenfn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [out] PHANDLE ImpersonationToken
)
{...}

Parametri

[in] ContextHandle

Handle per il contesto da rappresentare.

[out] ImpersonationToken

Puntatore che riceve un handle al token per il contesto specificato. Restituire l'handle al token senza prima duplicare l'handle o il token.

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. Di seguito viene elencato un motivo comune per l'errore e il codice di errore restituito dalla funzione.

Codice restituito Descrizione
SEC_E_INVALID_HANDLE
 L'handle non è valido.

Commenti

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

Un puntatore alla funzione SpGetContextToken è disponibile nella struttura SECPKG_USER_FUNCTION_TABLE ricevuta dalla funzione SpUserModeInitialize .

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

ImpersonateSecurityContext

SECPKG_USER_FUNCTION_TABLE

SpUserModeInitialize