Função CredProtectA (wincred.h)

Artigo
11/20/2024

A função CredProtect criptografa as credenciais especificadas para que somente 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 pszCredentials buffer.

[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 pszProtectedCredentials buffer. 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 pszProtectedCredentials buffer.

[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 de retorno

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

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

Observações

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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wincred.h
biblioteca	Advapi32.lib
de DLL	Advapi32.dll

Compartilhar via