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 |