Funzione di callback KspVerifySignatureFn (ntsecpkg.h)

  • Articolo

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
SEC_E_INVALID_HANDLE
 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

Vedi anche

MakeSignature

SECPKG_USER_FUNCTION_TABLE

SpMakeSignature

SpUserModeInitialize

VerifySignature