ICredentialProvider：：SetUsageScenario 方法 (credentialprovider.h)

發行項
08/22/2023

定義認證提供者有效的案例。每當初始化認證提供者時呼叫。

語法

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

參數

[in] cpus

類型： CREDENTIAL_PROVIDER_USAGE_SCENARIO

認證提供者已建立的案例。這是需要支援的使用案例。如需詳細資訊，請參閱。

[in] dwFlags

類型： DWORD

影響認證提供者行為的值。這個值可以是 Wincred.h 中定義的一或多個下列值的位 OR 組合。如需詳細資訊，請參閱 CredUIPromptForWindowsCredentials 。

CREDUIWIN_GENERIC (0x00000001)

0x00000001。呼叫端要求認證提供者以純文字傳回使用者名稱和密碼。此值無法與 CREDUIWIN_SECURE_PROMPT結合。

CREDUIWIN_CHECKBOX (0x00000002)

0x00000002。 [ 儲存] 核取方塊會顯示在對話方塊中。

CREDUIWIN_AUTHPACKAGE_ONLY (0x00000010)

0x00000010。只應該列舉支援輸入驗證套件的認證提供者。如果認證提供者不支援輸入驗證套件，他們應該列舉零個使用者磚。此值無法與 CREDUIWIN_IN_CRED_ONLY結合。

CREDUIWIN_IN_CRED_ONLY (0x00000020)

0x00000020。如果提供者可以序列化認證，則它應該列舉該認證的圖格。不應該列舉其他磚。認證提供者應該使用ICredentialProvider：：SetSerialization中的輸入CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION，以及ICredentialProvider：：SetUsageScenario中的dwFlags，以判斷要列舉的認證磚數目。此值無法與 CREDUIWIN_AUTHPACKAGE_ONLY結合。

CREDUIWIN_ENUMERATE_ADMINS (0x00000100)

0x00000100。認證提供者應該只列舉系統管理員。此值僅供 UAC 之用。我們建議外部呼叫端未設定此旗標。

CREDUIWIN_ENUMERATE_CURRENT_USER (0x00000200)

0x00000200。認證提供者應該列舉目前登入使用者的圖格。

CREDUIWIN_SECURE_PROMPT (0x00001000)

0x00001000。認證對話方塊應該會顯示在安全桌面上。此值無法與 CREDUIWIN_GENERIC結合。認證提供者實作者可以安全地忽略此旗標。

CREDUIWIN_PACK_32_WOW (0x10000000)

0x10000000。傳遞至提供者的緩衝區為 32 位。從提供者傳回的緩衝區也必須是 32 位。這是 WOW64 的必要專案。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

備註

這是必要方法，可讓認證提供者指出其使用方式。

如果呼叫完成，但不支援要求的使用案例，這個方法應該會傳回 E_NOTIMPL 。如果方法成功且支援使用案例，這個方法應該會傳回 S_OK 。

規格需求


最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	credentialprovider.h

共用方式為