Metode ICredentialProvider::SetUsageScenario (credentialprovider.h)

Artikel
08/22/2023

Menentukan skenario di mana penyedia kredensial valid. Dipanggil setiap kali penyedia kredensial diinisialisasi.

Sintaks

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

Parameter

[in] cpus

Jenis: CREDENTIAL_PROVIDER_USAGE_SCENARIO

Skenario tempat penyedia kredensial dibuat. Ini adalah skenario penggunaan yang perlu didukung. Lihat Keterangan untuk informasi selengkapnya.

[in] dwFlags

Jenis: DWORD

Nilai yang memengaruhi perilaku penyedia kredensial. Nilai ini bisa menjadi kombinasi bitwise-OR dari satu atau beberapa nilai berikut yang ditentukan dalam Wincred.h. Lihat CredUIPromptForWindowsCredentials untuk informasi selengkapnya.

CREDUIWIN_GENERIC (0x00000001)

0x00000001. Pemanggil meminta agar penyedia kredensial mengembalikan nama pengguna dan kata sandi dalam teks biasa. Nilai ini tidak dapat digabungkan dengan CREDUIWIN_SECURE_PROMPT.

CREDUIWIN_CHECKBOX (0x00000002)

0x00000002. Kotak centang Simpan ditampilkan dalam kotak dialog.

CREDUIWIN_AUTHPACKAGE_ONLY (0x00000010)

0x00000010. Hanya penyedia kredensial yang mendukung paket autentikasi input yang harus dijumlahkan. Jika penyedia kredensial tidak mendukung paket autentikasi input, mereka harus menghitung petak peta pengguna nol. Nilai ini tidak dapat digabungkan dengan CREDUIWIN_IN_CRED_ONLY.

CREDUIWIN_IN_CRED_ONLY (0x00000020)

0x00000020. Jika penyedia dapat menserialisasikan kredensial, maka penyedia harus menghitung petak untuk kredensial tersebut. Tidak ada petak peta lain yang harus dijumlahkan. Penyedia info masuk harus menggunakan CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION input di ICredentialProvider::SetSerialization dan dwFlags di ICredentialProvider::SetUsageScenario untuk menentukan berapa banyak petak kredensial yang akan dijumlahkan. Nilai ini tidak dapat digabungkan dengan CREDUIWIN_AUTHPACKAGE_ONLY.

CREDUIWIN_ENUMERATE_ADMINS (0x00000100)

0x00000100. Penyedia kredensial hanya boleh menghitung administrator. Nilai ini hanya ditujukan untuk tujuan UAC. Kami menyarankan agar penelepon eksternal tidak mengatur bendera ini.

CREDUIWIN_ENUMERATE_CURRENT_USER (0x00000200)

0x00000200. Penyedia kredensial harus menghitung petak peta untuk pengguna yang saat ini masuk.

CREDUIWIN_SECURE_PROMPT (0x00001000)

0x00001000. Kotak dialog kredensial harus ditampilkan di desktop aman. Nilai ini tidak dapat digabungkan dengan CREDUIWIN_GENERIC. Pelaksana penyedia kredensial dapat mengabaikan bendera ini dengan aman.

CREDUIWIN_PACK_32_WOW (0x10000000)

0x10000000. Buffer yang diteruskan ke penyedia adalah 32-bit. Buffer yang dikembalikan dari penyedia juga harus 32-bit. Ini diperlukan untuk WOW64.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Metode ini diperlukan dan memungkinkan penyedia kredensial untuk menunjukkan bagaimana metode tersebut akan digunakan.

Metode ini harus mengembalikan E_NOTIMPL jika panggilan selesai tetapi skenario penggunaan yang diminta tidak didukung. Metode ini harus mengembalikan S_OK jika metode berhasil dan skenario penggunaan didukung.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	credentialprovider.h

Bagikan melalui