ICredentialProvider::SetUsageScenario-Methode (credentialprovider.h)

Artikel
08/22/2023

Definiert die Szenarien, für die der Anmeldeinformationsanbieter gültig ist. Wird immer dann aufgerufen, wenn der Anmeldeinformationsanbieter initialisiert wird.

Syntax

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

Parameter

[in] cpus

Typ: CREDENTIAL_PROVIDER_USAGE_SCENARIO

Das Szenario, in dem der Anmeldeinformationsanbieter erstellt wurde. Dies ist das Nutzungsszenario, das unterstützt werden muss. Weitere Informationen finden Sie in den Hinweisen.

[in] dwFlags

Art: DWORD

Ein Wert, der das Verhalten des Anmeldeinformationsanbieters beeinflusst. Dieser Wert kann eine bitweise OR-Kombination aus einem oder mehreren der folgenden Werte sein, die in Wincred.h definiert sind. Weitere Informationen finden Sie unter CredUIPromptForWindowsCredentials .

CREDUIWIN_GENERIC (0x00000001)

0x00000001. Der Aufrufer fordert den Anmeldeinformationsanbieter auf, den Benutzernamen und das Kennwort in Nur-Text zurückzugeben. Dieser Wert kann nicht mit CREDUIWIN_SECURE_PROMPT kombiniert werden.

CREDUIWIN_CHECKBOX (0x00000002)

0x00000002. Das Kontrollkästchen Speichern wird im Dialogfeld angezeigt.

CREDUIWIN_AUTHPACKAGE_ONLY (0x00000010)

0x00000010. Es sollten nur Anmeldeinformationsanbieter aufgelistet werden, die das Eingabeauthentifizierungspaket unterstützen. Wenn Anmeldeinformationsanbieter das Eingabeauthentifizierungspaket nicht unterstützen, sollten sie null Benutzerkacheln aufzählen. Dieser Wert kann nicht mit CREDUIWIN_IN_CRED_ONLY kombiniert werden.

CREDUIWIN_IN_CRED_ONLY (0x00000020)

0x00000020. Wenn der Anbieter die Anmeldeinformationen serialisieren kann, sollte er eine Kachel für diese Anmeldeinformationen auflisten. Es sollten keine anderen Kacheln aufgelistet werden. Anmeldeinformationsanbieter sollten die Eingabe CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION in ICredentialProvider::SetSerialization und dwFlags in ICredentialProvider::SetUsageScenario verwenden, um zu bestimmen, wie viele Anmeldeinformationskacheln aufgelistet werden sollen. Dieser Wert kann nicht mit CREDUIWIN_AUTHPACKAGE_ONLY kombiniert werden.

CREDUIWIN_ENUMERATE_ADMINS (0x00000100)

0x00000100. Anmeldeinformationsanbieter sollten nur Administratoren auflisten. Dieser Wert ist nur für UAC-Zwecke vorgesehen. Externe Aufrufer sollten dieses Flag nicht festlegen.

CREDUIWIN_ENUMERATE_CURRENT_USER (0x00000200)

0x00000200. Anmeldeinformationsanbieter sollten eine Kachel für den aktuell angemeldeten Benutzer auflisten.

CREDUIWIN_SECURE_PROMPT (0x00001000)

0x00001000. Das Dialogfeld "Anmeldeinformationen" sollte auf dem sicheren Desktop angezeigt werden. Dieser Wert kann nicht mit CREDUIWIN_GENERIC kombiniert werden. Die Implementierung von Anmeldeinformationsanbietern kann dieses Flag sicher ignorieren.

CREDUIWIN_PACK_32_WOW (0x10000000)

0x10000000. Puffer, die an den Anbieter übergeben werden, sind 32-Bit. Puffer, die vom Anbieter zurückgegeben werden, müssen ebenfalls 32-Bit sein. Dies ist für WOW64 erforderlich.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode ist erforderlich und ermöglicht es dem Anmeldeinformationsanbieter, anzugeben, wie sie verwendet wird.

Diese Methode sollte E_NOTIMPL zurückgeben, wenn der Aufruf abgeschlossen ist, das angeforderte Nutzungsszenario jedoch nicht unterstützt wird. Diese Methode sollte S_OK zurückgeben, wenn die Methode erfolgreich ist und das Nutzungsszenario unterstützt wird.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	credentialprovider.h

Share via