Função CredUnprotectW (wincred.h)

Artigo
11/20/2024

A função CredUnprotect descriptografa credenciais que foram criptografadas anteriormente usando a função CredProtect. As credenciais devem ter sido criptografadas no mesmo contexto de segurança no qual credUnprotect é chamado.

Sintaxe

BOOL CredUnprotectW(
  [in]      BOOL   fAsSelf,
  [in]      LPWSTR pszProtectedCredentials,
  [in]      DWORD  cchProtectedCredentials,
  [out]     LPWSTR pszCredentials,
  [in, out] DWORD  *pcchMaxChars
);

Parâmetros

[in] fAsSelf

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

[in] pszProtectedCredentials

Um ponteiro para uma cadeia de caracteres que especifica as credenciais criptografadas.

[in] cchProtectedCredentials

O tamanho, em caracteres, do pszProtectedCredentials buffer.

[out] pszCredentials

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

[in, out] pcchMaxChars

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

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. A tabela a seguir mostra valores comuns para a função GetLastError .

Código/valor de retorno	Descrição
ERROR_NOT_CAPABLE	O contexto de segurança usado para criptografar as credenciais é diferente do contexto de segurança usado para descriptografar as credenciais.
ERROR_INSUFFICIENT_BUFFER	O pszCredentials buffer era de tamanho insuficiente.

Observações

Nota

O cabeçalho wincred.h define CredUnprotect 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

Partilhar via