Função CredProtectA (wincred.h)

A função CredProtect criptografa as credenciais especificadas para que apenas o contexto de segurança atual possa descriptografá-las.

Sintaxe

BOOL CredProtectA(
  [in]      BOOL                 fAsSelf,
  [in]      LPSTR                pszCredentials,
  [in]      DWORD                cchCredentials,
  [out]     LPSTR                pszProtectedCredentials,
  [in, out] DWORD                *pcchMaxChars,
  [out]     CRED_PROTECTION_TYPE *ProtectionType
);

Parâmetros

[in] fAsSelf

Defina como TRUE para especificar que as credenciais são criptografadas no contexto de segurança do processo atual. Defina como FALSE para especificar que as credenciais são criptografadas no contexto de segurança do contexto de segurança do thread de chamada.

[in] pszCredentials

Um ponteiro para uma cadeia de caracteres que especifica as credenciais a serem criptografadas. A função criptografa o número de caracteres fornecidos no parâmetro cchCredentials .

[in] cchCredentials

O tamanho, em caracteres, do buffer pszCredentials .

[out] pszProtectedCredentials

Um ponteiro para uma cadeia de caracteres que, na saída, recebe as credenciais criptografadas.

[in, out] pcchMaxChars

O tamanho, em caracteres do buffer pszProtectedCredentials . Na saída, se o pszProtectedCredentials não for de tamanho suficiente para receber as credenciais criptografadas, esse parâmetro especificará o tamanho necessário, em caracteres, do buffer pszProtectedCredentials .

[out] ProtectionType

Um ponteiro para um tipo de enumeração CRED_PROTECTION_TYPE que, na saída, especifica o tipo de proteção fornecido.

Valor retornado

TRUE se a função for bem-sucedida; caso contrário, FALSE.

Para obter informações de erro estendidas, chame a função GetLastError .

Comentários

Observe que a saída da função CredProtect não está protegida por integridade, portanto, se a saída for modificada, a função CredUnprotect não será atualizada e poderá produzir resultados incorretos.

Observação

O cabeçalho wincred.h define CredProtect como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wincred.h
Biblioteca	Advapi32.lib
DLL	Advapi32.dll