Compartilhar via


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

Descriptografa uma mensagem que foi criptografada anteriormente com a função SpSealMessage .

A função SpUnsealMessage é a função de expedição para a função DecryptMessage (Geral) da Interface do Provedor de Suporte de Segurança.

Sintaxe

SpUnsealMessageFn Spunsealmessagefn;

NTSTATUS Spunsealmessagefn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [in]  PSecBufferDesc MessageBuffers,
  [in]  ULONG MessageSequenceNumber,
  [out] PULONG QualityOfProtection
)
{...}

Parâmetros

[in] ContextHandle

Identificador do contexto de segurança usado para selar a mensagem.

[in] MessageBuffers

Ponteiro para uma estrutura SecBufferDesc que contém os buffers de mensagem e um buffer de assinatura.

[in] MessageSequenceNumber

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] QualityOfProtection

Não usado.

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.

Comentários

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

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

DecryptMessage (Geral)

SECPKG_USER_FUNCTION_TABLE

SpSealMessage

SpUserModeInitialize