Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
A função EncryptMessage (Kerberos) criptografa uma mensagem para fornecer privacidade. EncryptMessage (Kerberos) permite que um aplicativo escolha entre algoritmos criptográficos suportados pelo mecanismo escolhido. A função EncryptMessage (Kerberos) usa o contexto de segurança referenciado pelo identificador de contexto. Alguns pacotes não têm mensagens a serem criptografadas ou descriptografadas, mas fornecem um hash de integridade que pode ser verificado.
Observação
EncryptMessage (Kerberos) e DecryptMessage (Kerberos) podem ser chamados ao mesmo tempo a partir de dois threads diferentes em um único contexto SSPI ( security support provider interface ) se um thread estiver criptografando e o outro estiver descriptografando. Se mais de um thread estiver criptografando ou mais de um thread estiver descriptografando, cada thread deverá obter um contexto exclusivo.
Sintaxe
SECURITY_STATUS SEC_Entry EncryptMessage(
_In_ PCtxtHandle phContext,
_In_ ULONG fQOP,
_Inout_ PSecBufferDesc pMessage,
_In_ ULONG MessageSeqNo
);
Parâmetros
-
phContext [em]
-
Um identificador para o contexto de segurança a ser usado para criptografar a mensagem.
-
fQOP [em]
-
Sinalizadores específicos da embalagem que indicam a qualidade da proteção. Um pacote de segurança pode usar esse parâmetro para habilitar a seleção de algoritmos criptográficos.
Este parâmetro pode ser o seguinte sinalizador.
Valor Significado SECQOP_WRAP_NO_ENCRYPT Produza um cabeçalho ou trailer, mas não criptografe a mensagem.
Observação: KERB_WRAP_NO_ENCRYPT tem o mesmo valor e o mesmo significado. -
pMessage [entrada, saída]
-
Um ponteiro para uma estrutura SecBufferDesc . Na entrada, a estrutura faz referência a uma ou mais estruturas SecBuffer que podem ser do tipo SECBUFFER_DATA. Esse buffer contém a mensagem a ser criptografada. A mensagem é criptografada no local, substituindo o conteúdo original da estrutura.
A função não processa buffers com o atributo SECBUFFER_READONLY.
O comprimento da estrutura SecBuffer que contém a mensagem não deve ser maior do que cbMaximumMessage, que é obtido a partir da função QueryContextAttributes (Kerberos) (SECPKG_ATTR_STREAM_SIZES).
Os aplicativos que não usam SSL devem fornecer um SecBuffer do tipo SECBUFFER_PADDING.
-
MessageSeqNo [em]
-
O número de sequência que o aplicativo de transporte atribuiu à mensagem. Se o aplicativo de transporte não mantiver números de sequência, esse parâmetro deverá ser zero.
Valor de retorno
Se a função for bem-sucedida, a função retornará SEC_E_OK.
Se a função falhar, ela retornará um dos seguintes códigos de erro.
| Código de retorno | Descrição |
|---|---|
|
O buffer de saída é muito pequeno. Para obter mais informações, consulte Observações. |
|
O aplicativo está fazendo referência a um contexto que já foi fechado. Um aplicativo escrito corretamente não deve receber esse erro. |
|
A cifra escolhida para o contexto de segurança não é suportada. |
|
Não há memória suficiente disponível para concluir a ação solicitada. |
|
Um identificador de contexto que não é válido foi especificado no parâmetro phContext . |
|
Nenhum buffer de tipo SECBUFFER_DATA foi encontrado. |
|
Nem a confidencialidade nem a integridade são suportadas pelo contexto de segurança. |
Observações
A função EncryptMessage (Kerberos) criptografa uma mensagem com base na mensagem e na chave de sessão de um contexto de segurança.
Se o aplicativo de transporte criou o contexto de segurança para dar suporte à deteção de sequência e o chamador fornece um número de sequência, a função inclui essas informações com a mensagem criptografada. A inclusão dessas informações protege contra reprodução, inserção e supressão de mensagens. O pacote de segurança incorpora o número de sequência transmitido a partir do aplicativo de transporte.
Observação
Esses buffers devem ser fornecidos na ordem mostrada.
| Tipo de buffer | Descrição |
|---|---|
| SECBUFFER_STREAM_HEADER< | Usado internamente. Nenhuma inicialização necessária. |
| SECBUFFER_DATA | Contém a mensagem de texto simples a ser criptografada. |
| SECBUFFER_STREAM_TRAILER | Usado internamente. Nenhuma inicialização necessária. |
| SECBUFFER_EMPTY | Usado internamente. Nenhuma inicialização necessária. O tamanho pode ser zero. |
Para um desempenho ideal, as estruturas pMessage devem ser alocadas a partir da memória contígua.
Windows XP: Esta função também era conhecida como SealMessage. Os aplicativos agora devem usar apenas EncryptMessage (Kerberos ).
Requerimentos
| Requisito | Valor |
|---|---|
| Cliente mínimo suportado | Windows XP [apenas aplicações de ambiente de trabalho] |
| Servidor mínimo suportado | Windows Server 2003 [apenas aplicações de ambiente de trabalho] |
| Cabeçalho | Sspi.h (inclui Security.h) |
| Biblioteca | Secur32.lib |
| DLL | Secur32.dll |