Metode ICredentialProviderCredential::GetSubmitButtonValue (credentialprovider.h)

Artikel
08/22/2023

Mengambil pengidentifikasi bidang yang harus ditempatkan tombol kirim di samping di UI Masuk. Antarmuka pengguna Kredensial tidak memanggil metode ini.

Sintaks

HRESULT GetSubmitButtonValue(
  [in]  DWORD dwFieldID,
  [out] DWORD *pdwAdjacentTo
);

Parameter

[in] dwFieldID

Jenis: DWORD

Pengidentifikasi untuk bidang nilai tombol kirim diperlukan.

[out] pdwAdjacentTo

Jenis: DWORD*

Penunjuk ke nilai yang menerima ID bidang dari bidang tempat tombol kirim harus ditempatkan di sampingnya.

Catatan untuk pelaksana: Jangan mengembalikan ID bidang bitmap dalam parameter ini. Desain UI yang tidak baik untuk menempatkan tombol kirim di samping bitmap, dan melakukannya dapat menyebabkan kegagalan di UI Masuk.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Tombol kirim tidak diberi label seperti itu; itu hanyalah cara umum untuk merujuk ke tombol yang Anda klik untuk mengirimkan kredensial. Tombol biasanya muncul sebagai tombol melingkar yang berisi panah yang menunjuk ke kanan, meskipun tampilan ini dapat berubah dalam rilis selanjutnya. Untuk informasi selengkapnya, lihat CPFT_SUBMIT_BUTTON.

Anda tidak boleh menyembunyikan tombol kirim kecuali penyedia kredensial Anda selalu melakukan pengiriman otomatis. Jika tidak, itu bisa membingungkan pengguna karena mereka tidak akan melihat cara untuk mengirimkan kredensial mereka.

Panggil metode ini saat merakit UI Masuk. Misalnya penggunaan, lihat sampel Penyedia Info Masuk yang disertakan dalam Windows Software Development Kit (SDK).

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