Compartilhar via

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

  • Artigo

Criptografa uma mensagem trocada entre um cliente e um servidor.

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

Sintaxe

SpSealMessageFn Spsealmessagefn;

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

Parâmetros

[in] ContextHandle

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

[in] QualityOfProtection

Especifica sinalizadores específicos do pacote que indicam a qualidade da proteção. Um SSP/AP pode usar esse parâmetro para habilitar a seleção de algoritmos criptográficos.

[in, out] MessageBuffers

Ponteiro para uma estrutura SecBufferDesc que contém buffers de mensagem. Somente um desses buffers de mensagem pode ser do tipo SECBUFFER_DATA e contém a mensagem a ser criptografada. O buffer não pode ter o atributo SECBUFFER_READONLY porque a criptografia é feita in-loco.

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

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 os motivos comuns de falha e os códigos de erro que a função deve retornar.

Código de retorno Descrição
STATUS_INVALID_HANDLE
 O contexto não pôde ser encontrado ou não foi configurado para integridade da mensagem.
STATUS_INVALID_PARAMETER
 O buffer de assinatura não pôde ser encontrado ou era muito pequeno.

Comentários

As mensagens criptografadas pelo remetente usando a função SpSealMessage são descriptografadas usando a função SpUnsealMessage .

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

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

SECPKG_USER_FUNCTION_TABLE

SpUnsealMessage

SpUserModeInitialize