Méthode ICredentialProvider::SetUsageScenario (credentialprovider.h)

Article
08/22/2023

Définit les scénarios pour lesquels le fournisseur d’informations d’identification est valide. Appelé chaque fois que le fournisseur d’informations d’identification est initialisé.

Syntaxe

HRESULT SetUsageScenario(
  [in] CREDENTIAL_PROVIDER_USAGE_SCENARIO cpus,
  [in] DWORD                              dwFlags
);

Paramètres

[in] cpus

Type : CREDENTIAL_PROVIDER_USAGE_SCENARIO

Scénario dans lequel le fournisseur d’informations d’identification a été créé. Il s’agit du scénario d’utilisation qui doit être pris en charge. Pour plus d’informations, consultez les remarques.

[in] dwFlags

Type : DWORD

Valeur qui affecte le comportement du fournisseur d’informations d’identification. Cette valeur peut être une combinaison OR au niveau du bit d’une ou plusieurs des valeurs suivantes définies dans Wincred.h. Pour plus d’informations, consultez CredUIPromptForWindowsCredentials .

CREDUIWIN_GENERIC (0x00000001)

0x00000001. L’appelant demande que le fournisseur d’informations d’identification retourne le nom d’utilisateur et le mot de passe en texte brut. Cette valeur ne peut pas être combinée avec CREDUIWIN_SECURE_PROMPT.

CREDUIWIN_CHECKBOX (0x00000002)

0x00000002. La zone Enregistrer case activée s’affiche dans la boîte de dialogue.

CREDUIWIN_AUTHPACKAGE_ONLY (0x00000010)

0x00000010. Seuls les fournisseurs d’informations d’identification qui prennent en charge le package d’authentification d’entrée doivent être énumérés. Si les fournisseurs d’informations d’identification ne prennent pas en charge le package d’authentification d’entrée, ils ne doivent énumérer aucune vignette utilisateur. Cette valeur ne peut pas être combinée avec CREDUIWIN_IN_CRED_ONLY.

CREDUIWIN_IN_CRED_ONLY (0x00000020)

0x00000020. Si le fournisseur peut sérialiser les informations d’identification, il doit énumérer une vignette pour ces informations d’identification. Aucune autre vignette ne doit être énumérée. Les fournisseurs d’informations d’identification doivent utiliser les CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION d’entrée dans ICredentialProvider::SetSerialization et dwFlags dans ICredentialProvider::SetUsageScenario afin de déterminer le nombre de vignettes d’informations d’identification à énumérer. Cette valeur ne peut pas être combinée avec CREDUIWIN_AUTHPACKAGE_ONLY.

CREDUIWIN_ENUMERATE_ADMINS (0x00000100)

0x00000100. Les fournisseurs d’informations d’identification doivent énumérer uniquement les administrateurs. Cette valeur est destinée uniquement à des fins UAC. Nous recommandons aux appelants externes de ne pas définir cet indicateur.

CREDUIWIN_ENUMERATE_CURRENT_USER (0x00000200)

0x00000200. Les fournisseurs d’informations d’identification doivent énumérer une vignette pour l’utilisateur actuellement connecté.

CREDUIWIN_SECURE_PROMPT (0x00001000)

0x00001000. La boîte de dialogue d’informations d’identification doit être affichée sur le bureau sécurisé. Cette valeur ne peut pas être combinée avec CREDUIWIN_GENERIC. Les implémenteurs du fournisseur d’informations d’identification peuvent ignorer cet indicateur en toute sécurité.

CREDUIWIN_PACK_32_WOW (0x10000000)

0x10000000. Les mémoires tampons passées au fournisseur sont 32 bits. Les mémoires tampons retournées par le fournisseur doivent également être 32 bits. Cela est nécessaire pour WOW64.

Valeur retournée

Type : HRESULT

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

Remarques

Cette méthode est obligatoire et permet au fournisseur d’informations d’identification d’indiquer comment elle sera utilisée.

Cette méthode doit retourner E_NOTIMPL si l’appel se termine, mais que le scénario d’utilisation demandé n’est pas pris en charge. Cette méthode doit retourner S_OK si la méthode réussit et si le scénario d’utilisation est pris en charge.

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

Partager via