Funzione callback KspMakeSignatureFn (ntsecpkg.h)

Articolo
02/29/2024

La funzione SpMakeSignature genera una firma in base al contesto di sicurezza e al messaggio specificato.

La funzione SpMakeSignature è la funzione di invio per la funzione MakeSignature dell'interfaccia del provider di supporto della sicurezza.

Sintassi

KspMakeSignatureFn Kspmakesignaturefn;

NTSTATUS Kspmakesignaturefn(
  [in] LSA_SEC_HANDLE ContextId,
  [in] ULONG fQOP,
  [in] PSecBufferDesc Message,
  [in] ULONG MessageSeqNo
)
{...}

Parametri

[in] ContextId

Handle al contesto di sicurezza da usare per generare la firma del messaggio.

[in] fQOP

Specifica i flag specifici del pacchetto che indicano la qualità della protezione. Un pacchetto di sicurezza può usare questo parametro per supportare la selezione di algoritmi crittografici

[in] Message

Puntatore a una struttura SecBuffer . In input la struttura contiene il messaggio da firmare.

[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.

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. Di seguito viene elencato un motivo comune per l'errore e il codice di errore restituito dalla funzione.

Codice restituito	Descrizione
SEC_E_INVALID_HANDLE	L'handle non è valido.

Commenti

La controparte della funzione SpMakeSignature è la funzione SpVerifySignature, usata per verificare le firme alla fine della ricezione.

SSP/APs deve implementare la funzione SpMakeSignature ; tuttavia, il nome effettivo assegnato all'implementazione è fino allo sviluppatore.

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

SpUserModeInitialize

SpVerifySignature

Condividi tramite