Função de retorno de chamada KspVerifySignatureFn (ntsecpkg.h)

Artigo
03/05/2024

Verifica se a mensagem recebida está correta de acordo com a assinatura.

A função SpVerifySignature é a função de expedição para a função VerifySignature da Interface do Provedor de Suporte de Segurança.

Sintaxe

KspVerifySignatureFn Kspverifysignaturefn;

NTSTATUS Kspverifysignaturefn(
        LSA_SEC_HANDLE ContextId,
  [in]  PSecBufferDesc Message,
  [in]  ULONG MessageSeqNo,
  [out] PULONG pfQOP
)
{...}

Parâmetros

ContextId

[in] Message

Ponteiro para uma estrutura SecBufferDesc que contém a mensagem a ser verificada.

[in] MessageSeqNo

Número de sequência a ser atribuído à mensagem. Os números de sequência são opcionais e são usados como proteção contra perda e inserção de mensagens. Um valor zero indica que os números de sequência não estão em uso.

[out] pfQOP

Ponteiro para sinalizadores específicos do pacote que indicam a qualidade da proteção.

Retornar valor

Se a função for bem-sucedida, retorne STATUS_SUCCESS.

Se a função falhar, retorne um código NTSTATUS que indica o motivo pelo qual ela falhou. A tabela a seguir lista um motivo comum para falha e o código de erro que a função deve retornar.

Código de retorno	Descrição
SEC_E_INVALID_HANDLE	O identificador não é válido.

Comentários

A assinatura verificada pela função SpVerifySignature é criada pela função SpMakeSignature , usada por um remetente de mensagem.

SSP/APs devem implementar a função SpVerifySignature ; no entanto, o nome real fornecido à implementação cabe ao desenvolvedor.

Um ponteiro para a função SpVerifySignature está disponível na estrutura SECPKG_USER_FUNCTION_TABLE recebida da função SpUserModeInitialize .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ntsecpkg.h