Compartilhar via


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

A função SpMakeSignature gera uma assinatura com base no contexto de segurança e mensagem especificados.

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

Sintaxe

KspMakeSignatureFn Kspmakesignaturefn;

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

Parâmetros

[in] ContextId

Um identificador para o contexto de segurança a ser usado para gerar a assinatura da mensagem.

[in] fQOP

Especifica sinalizadores específicos do pacote que indicam a qualidade da proteção. Um pacote de segurança pode usar esse parâmetro para dar suporte à seleção de algoritmos criptográficos

[in] Message

Ponteiro para uma estrutura SecBuffer . Na entrada, a estrutura contém a mensagem a ser assinada.

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

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. O seguinte 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

O equivalente à função SpMakeSignature é a função SpVerifySignature , usada para verificar assinaturas na extremidade de recebimento.

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

Um ponteiro para a função SpMakeSignature 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

Confira também

Makesignature

SECPKG_USER_FUNCTION_TABLE

SpUserModeInitialize

SpVerifySignature