Método ICredentialProviderCredential::GetStringValue (credentialprovider.h)

Habilita a recuperação de texto de uma credencial com um campo de texto.

Sintaxe

HRESULT GetStringValue(
  [in]  DWORD  dwFieldID,
  [out] LPWSTR *ppsz
);

Parâmetros

[in] dwFieldID

Tipo: DWORD

O identificador do campo.

[out] ppsz

Tipo: LPWSTR*

Um ponteiro para a memória que contém uma cadeia de caracteres Unicode terminada em nulo para retornar à interface do usuário de logon ou à interface do usuário de credencial.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método é opcional.

A interface do usuário de logon e a interface do usuário de credencial nos dão esse método para obter o pszLabel para um campo. Essas informações são necessárias para obter valores para campos CPFT_LARGE_TEXT, CPFT_SMALL_TEXT, CPFT_COMMAND_LINK, CPFT_EDIT_TEXT e CPFT_PASSWORD_TEXT .

Práticas recomendadas do provedor de credenciais

Os provedores de credenciais lidam com segredos de usuário extremamente confidenciais para concluir solicitações de logon e desbloqueio. Como prática recomendada, as informações secretas, como senhas e PINs, devem ser tratadas com o maior cuidado. As técnicas adequadas para lidar com informações secretas em um provedor de credenciais são:

• Sempre descarte segredos com segurança. Para fazer isso, chame SecureZeroMemory antes de liberar a memória usada para manter qualquer segredo.
• Descarte os segredos com segurança imediatamente depois que eles forem usados.
• Descarte segredos com segurança se eles não forem usados para a finalidade pretendida dentro de um período esperado.

Requisitos

Requisito	Valor
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	credentialprovider.h