Função SspiEncryptAuthIdentityEx (sspi.h)

  • Artigo

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. Esse pode ser um ou mais dos valores a seguir.

Valor Significado
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 persistido 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.

Retornar valor

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.

Comentários

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 .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho sspi.h