Funzione di callback KspVerifySignatureFn (ntsecpkg.h)
Verifica che il messaggio ricevuto sia corretto in base alla firma.
La funzione SpVerifySignature è la funzione di invio per la funzione VerifySignaturedell'interfaccia del provider di supporto della sicurezza.
Sintassi
KspVerifySignatureFn Kspverifysignaturefn;
NTSTATUS Kspverifysignaturefn(
LSA_SEC_HANDLE ContextId,
[in] PSecBufferDesc Message,
[in] ULONG MessageSeqNo,
[out] PULONG pfQOP
)
{...}
Parametri
ContextId
[in] Message
Puntatore a una struttura SecBufferDesc contenente il messaggio da verificare.
[in] MessageSeqNo
Numero di sequenza da assegnare al messaggio. I numeri di sequenza sono facoltativi e vengono usati come protezione dalla perdita e dall'inserimento di messaggi. Un valore pari a zero indica che i numeri di sequenza non sono in uso.
[out] pfQOP
Puntatore a flag specifici del pacchetto che indicano la qualità della protezione.
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. La tabella seguente elenca un motivo comune per l'errore e il codice di errore che la funzione deve restituire.
| Codice restituito | Descrizione |
|---|---|
|
L'handle non è valido. |
Commenti
La firma verificata dalla funzione SpVerifySignature viene creata dalla funzione SpMakeSignature , utilizzata da un mittente di messaggi.
SSP/APs deve implementare la funzione SpVerifySignature ; tuttavia, il nome effettivo assegnato all'implementazione è fino allo sviluppatore.
Un puntatore alla funzione SpVerifySignature è 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 |