Funzione di callback spGetContextTokenFn (ntsecpkg.h)
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 |
|---|---|
|
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 |