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
Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | credentialprovider.h |