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 |