Funzione di callback SpUnsealMessageFn (ntsecpkg.h)

Decrittografa un messaggio crittografato in precedenza con la funzione SpSealMessage .

La funzione SpUnsealMessage è la funzione dispatch per la funzione DecryptMessage (Generale)dell'interfaccia del provider di supporto di sicurezza.

Sintassi

SpUnsealMessageFn Spunsealmessagefn;

NTSTATUS Spunsealmessagefn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [in]  PSecBufferDesc MessageBuffers,
  [in]  ULONG MessageSequenceNumber,
  [out] PULONG QualityOfProtection
)
{...}

Parametri

[in] ContextHandle

Handle del contesto di sicurezza usato per bloccare il messaggio.

[in] MessageBuffers

Puntatore a una struttura SecBufferDesc che contiene i buffer dei messaggi e un buffer di firma.

[in] MessageSequenceNumber

Numero di sequenza da assegnare al messaggio. I numeri di sequenza sono facoltativi e vengono usati come protezione dalla perdita e dall'inserimento dei messaggi. Il valore zero indica che i numeri di sequenza non sono in uso.

[out] QualityOfProtection

Non usato.

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.

Commenti

SSP/APs deve implementare la funzione SpUnsealMessage ; Tuttavia, il nome effettivo assegnato all'implementazione spetta allo sviluppatore.

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

DecryptMessage (Generale)

SECPKG_USER_FUNCTION_TABLE

SpSealMessage

SpUserModeInitialize