Compartir a través de

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

  • Artículo

Recupera el identificador de un campo al que se debe colocar el botón enviar junto a en la interfaz de usuario de inicio de sesión. La interfaz de usuario de credenciales no llama a este método.

Sintaxis

HRESULT GetSubmitButtonValue(
  [in]  DWORD dwFieldID,
  [out] DWORD *pdwAdjacentTo
);

Parámetros

[in] dwFieldID

Tipo: DWORD

Se necesita el identificador del campo para el que se necesita un valor de botón de envío.

[out] pdwAdjacentTo

Tipo: DWORD*

Puntero a un valor que recibe el identificador de campo del campo al que se debe colocar el botón enviar junto a .

Tenga en cuenta que los implementadores: No devuelva el identificador de campo de un mapa de bits en este parámetro. No es un buen diseño de interfaz de usuario colocar el botón enviar junto a un mapa de bits y hacerlo puede provocar un error en la interfaz de usuario de inicio de sesión.

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

El botón enviar no está etiquetado como tal; es simplemente una manera genérica de hacer referencia al botón que hace clic para enviar las credenciales. El botón normalmente aparece como un botón circular que contiene una flecha que apunta a la derecha, aunque esta apariencia podría cambiar en versiones posteriores. Para obtener más información, consulte CPFT_SUBMIT_BUTTON.

No debe ocultar el botón enviar a menos que el proveedor de credenciales realice siempre el envío automático. De lo contrario, puede resultar confuso para los usuarios, ya que no verán una manera de enviar sus credenciales.

Llame a este método al ensamblar la interfaz de usuario de inicio de sesión. Por ejemplo, consulte los ejemplos de proveedores de credenciales incluidos en el Kit de desarrollo de software (SDK) de Windows.

.

Requisitos

   
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