Metode ICredentialProvider::SetSerialization (credentialprovider.h)

  • Artikel

Mengatur karakteristik serialisasi penyedia kredensial.

Sintaks

HRESULT SetSerialization(
  [in] const CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION *pcpcs
);

Parameter

[in] pcpcs

Jenis: const CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION*

Penunjuk ke struktur CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION yang menyimpan karakteristik serialisasi penyedia kredensial.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Metode ini diperlukan. Ini menerima kredensial dan menentukan apakah pcpc adalah kredensial parsial atau penuh. Jika merupakan kredensial parsial, kredensial tersebut tidak lengkap atau diteruskan untuk tujuan menampilkan beberapa informasi kepada pengguna. Jika merupakan kredensial penuh, kredensial harus diserialisasikan dan dikirimkan. Gunakan anggota CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION dan bendera yang diteruskan di SetUsageScenario untuk menentukan cara menangani input. Tanggung jawab ada pada penyedia info masuk untuk memverifikasi integritas input. Antarmuka pengguna Kredensial dan UI Masuk tidak melakukan pemeriksaan apa pun pada struktur sebelum meneruskannya ke penyedia kredensial.

SetSerialization selalu dipanggil setelah SetUsageScenario. UI Masuk juga memanggil SetSerialization saat filter mengembalikan kredensial melalui UpdateRemoteCredential. Ini tidak menggunakan metode ini saat menghitung ulang petak peta karena panggilan ke CredentialsChanged. Antarmuka pengguna Kredensial memanggil SetSerialization ketika kredensial input telah di-suppled oleh aplikasi.

UI Kredensial memberlakukan aturan berikut berdasarkan dwFlags untuk instans penyedia konten ini yang ditentukan ketika SetUsageScenario dipanggil.

  • Jika bendera menyertakan CREDUIWIN_IN_CRED_ONLY, semua penyedia kredensial yang mengembalikan S_OK diaktifkan.
  • Jika bendera menyertakan CREDUIWIN_AUTHPACKAGE_ONLY, semua penyedia kredensial yang mengembalikan status keberhasilan diaktifkan.
  • Jika tidak satu pun dari bendera tersebut disertakan, maka antarmuka pengguna Kredensial mengikuti logika yang sama dengan UI Masuk dan semua penyedia kredensial yang mengimplementasikan CREDENTIAL_PROVIDER_USAGE_SCENARIOCPUS_REDUI akan diaktifkan terlepas dari nilai status yang dikembalikan.
Penyedia kredensial yang menerapkan CREDENTIAL_PROVIDER_USAGE_SCENARIOCPUS_LOGON dan mengembalikan kegagalan dari metode ini masih akan diaktifkan.

Persyaratan

Persyaratan Nilai
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