Compartilhar via

Função SspiEncryptAuthIdentityEx (sspi.h)

Criptografa uma estrutura de SEC_WINNT_AUTH_IDENTITY_OPAQUE .

Sintaxe

SECURITY_STATUS SEC_ENTRY SspiEncryptAuthIdentityEx(
  [in]      ULONG                           Options,
  [in, out] PSEC_WINNT_AUTH_IDENTITY_OPAQUE AuthData
);

Parâmetros

[in] Options

Opções de criptografia. Isso pode ser um ou mais dos valores a seguir.

Value Meaning
SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON
 A estrutura criptografada só pode ser descriptografada por um contexto de segurança na mesma sessão de logon. Essa opção é usada para proteger um buffer de identidade que está sendo enviado por um RPC local.
SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_PROCESS
 A estrutura criptografada só pode ser descriptografada pelo mesmo processo. Chamar a função com essa opção é equivalente a chamar SspiEncryptAuthIdentity. Essa opção é usada para proteger um buffer de identidade que está sendo mantido na memória privada de um processo por um longo período.

[in, out] AuthData

Na entrada, um ponteiro para um buffer de identidade a ser criptografado. Esse buffer deve estar preparado para criptografia antes da chamada para essa função. Isso pode ser feito chamando a função SspiEncryptAuthIdentity. Na saída, o buffer de identidade criptografado.

Valor de retorno

Se a função for bem-sucedida, ela retornará SEC_E_OK.

Se a função falhar, ela retornará um código de erro diferente de zero.

Observações

Para transferir credenciais com segurança entre processos, os aplicativos normalmente chamam essa função com a opção SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON, seguida por SspiMarshalAuthIdentity para obter um buffer de autenticação marshaled e seu comprimento. Por exemplo, o Provedor de Credenciais de Identidade Online faz isso para retornar o buffer de autenticação do método ICredentialProviderCredential::GetSerialization .

Requirements

Requirement Value
Cliente mínimo suportado Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows Server 2012 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header sspi.h
Library mincore.lib
  • Last updated on