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

  • Artículo

Habilita la recuperación de texto de una credencial con un campo de texto.

Sintaxis

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

Parámetros

[in] dwFieldID

Tipo: DWORD

Identificador del campo.

[out] ppsz

Tipo: LPWSTR*

Puntero a la memoria que contiene una cadena Unicode terminada en null para volver a la interfaz de usuario de inicio de sesión o a la interfaz de usuario de credenciales.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método es opcional.

La interfaz de usuario de inicio de sesión y la interfaz de usuario de credenciales usamos este método para obtener el pszLabel de un campo. Esta información es necesaria para obtener valores para los campos CPFT_LARGE_TEXT, CPFT_SMALL_TEXT, CPFT_COMMAND_LINK, CPFT_EDIT_TEXT y CPFT_PASSWORD_TEXT .

Procedimientos recomendados del proveedor de credenciales

Los proveedores de credenciales controlan secretos de usuario extremadamente confidenciales para completar las solicitudes de inicio de sesión y desbloqueo. Como procedimiento recomendado, la información secreta, como contraseñas y PIN, debe controlarse con el máximo cuidado. Las técnicas adecuadas para controlar la información secreta dentro de un proveedor de credenciales son:
  • Descartar siempre los secretos de forma segura. Para ello, llame a SecureZeroMemory antes de liberar la memoria usada para contener cualquier secreto.
  • Descarte los secretos de forma segura inmediatamente después de que se usen.
  • Descarte de forma segura los secretos si no se usan para su propósito previsto dentro de un período de tiempo esperado.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado credentialprovider.h