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

Récupère l’identificateur d’un champ auquel le bouton Envoyer doit être placé en regard dans l’interface utilisateur d’ouverture de session. L’interface utilisateur des informations d’identification n’appelle pas cette méthode.

Syntaxe

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

Paramètres

[in] dwFieldID

Type : DWORD

Identificateur du champ pour lequel une valeur de bouton d’envoi est nécessaire.

[out] pdwAdjacentTo

Type : DWORD*

Pointeur vers une valeur qui reçoit l’ID de champ du champ à laquelle le bouton d’envoi doit être placé en regard.

Remarque pour les implémenteurs : Ne retournez pas l’ID de champ d’une bitmap dans ce paramètre. Il n’est pas judicieux de placer le bouton Envoyer à côté d’une bitmap, ce qui peut entraîner un échec dans l’interface utilisateur d’ouverture de session.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Le bouton Envoyer n’est pas étiqueté en tant que tel ; il s’agit simplement d’un moyen générique de faire référence au bouton sur lequel vous cliquez pour envoyer les informations d’identification. Le bouton apparaît normalement sous la forme d’un bouton circulaire qui contient une flèche pointant vers la droite, bien que cette apparence puisse changer dans les versions ultérieures. Pour plus d’informations, consultez CPFT_SUBMIT_BUTTON.

Vous ne devez pas masquer le bouton Envoyer, sauf si votre fournisseur d’informations d’identification effectue toujours une soumission automatique. Sinon, cela peut prêter à confusion pour les utilisateurs, car ils ne verront pas de moyen de soumettre leurs informations d’identification.

Appelez cette méthode lors de l’assemblage de l’interface utilisateur d’ouverture de session. Pour obtenir un exemple d’utilisation, consultez les exemples de fournisseurs d’informations d’identification inclus dans le Kit de développement logiciel (SDK) Windows.

.

Configuration requise