Funzione SspiEncryptAuthIdentityEx (sspi.h)

Articolo
03/05/2024

Crittografa una struttura SEC_WINNT_AUTH_IDENTITY_OPAQUE .

Sintassi

SECURITY_STATUS SEC_ENTRY SspiEncryptAuthIdentityEx(
  [in]      ULONG                           Options,
  [in, out] PSEC_WINNT_AUTH_IDENTITY_OPAQUE AuthData
);

Parametri

[in] Options

Opzioni di crittografia. Può trattarsi di uno o più dei valori seguenti.

Valore	Significato
SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON	La struttura crittografata può essere decrittografata solo da un contesto di sicurezza nella stessa sessione di accesso. Questa opzione viene usata per proteggere un buffer di identità inviato tramite rpc locale.
SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_PROCESS	La struttura crittografata può essere decrittografata solo dallo stesso processo. La chiamata alla funzione con questa opzione equivale a chiamare SspiEncryptAuthIdentity. Questa opzione viene usata per proteggere un buffer di identità persistente nella memoria privata di un processo per un periodo prolungato.

[in, out] AuthData

In input, un puntatore a un buffer di identità da crittografare. Questo buffer deve essere preparato per la crittografia prima della chiamata a questa funzione. Questa operazione può essere eseguita chiamando la funzione SspiEncryptAuthIdentity. Nell'output, il buffer di identità crittografato.

Valore restituito

Se la funzione ha esito positivo, restituisce SEC_E_OK.

Se la funzione ha esito negativo, restituisce un codice di errore diverso da zero.

Commenti

Per trasferire le credenziali in modo sicuro tra processi, le applicazioni in genere chiamano questa funzione con l'opzione SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON, seguita da SspiMarshalAuthIdentity per ottenere un buffer di autenticazione con marshalling e la relativa lunghezza. Ad esempio, il provider di credenziali di identità online esegue questa operazione per restituire il buffer di autenticazione dal metodo ICredentialProviderCredential::GetSerialization .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	sspi.h

Condividi tramite