共用方式為

CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR結構 （credentialprovider.h）

描述認證中的單一欄位。 例如，字串或使用者影像。

語法

typedef struct _CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR {
  DWORD                          dwFieldID;
  CREDENTIAL_PROVIDER_FIELD_TYPE cpft;
  LPWSTR                         pszLabel;
  GUID                           guidFieldType;
} CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR;

Members

dwFieldID

類型：DWORD

欄位的唯一識別碼。 與指定認證提供者上的所有其他欄位相比，欄位應該具有唯一識別碼。 無論欄位是顯示還是隱藏，都是如此。

cpft

類型： CREDENTIAL_PROVIDER_FIELD_TYPE

欄位類型。

pszLabel

類型： LPWSTR

緩衝區的指標，其中包含欄位易記名稱作為 -terminated Unicode 字串。null 這用於可訪問性和排隊目的。 例如，某些標準欄位會有 “Username”、“Password” 和 “Log On To” 的易記名稱。

guidFieldType

類型： GUID

唯一識別欄位類型的 GUID。 此成員可讓您將現有認證提供者所提供的功能包裝在自己的提供者中。 不建議包裝認證提供者，因為它可能會導致非預期的行為，從而停用內建認證提供者。

下表列出 Windows 支援的 guidFieldType 值。 這些定義在 Shlguid.h 中。

價值觀 Meaning
CPFG_LOGON_USERNAME
DA15BBE8-954SD-4FD3-B0F4-1FB5B90B174B
 輸入文字方塊的使用者名稱。
CPFG_LOGON_PASSWORD
60624CFA-A477-47B1-8A8E-3A4A19981827
 輸入文字方塊的密碼。
CPFG_SMARTCARD_USERNAME
3e1ecf69-568c-4d96-9d59-46444174e2d6
 從插入的智慧卡取得的使用者名稱。
CPFG_SMARTCARD_PIN
4fe5263b-9181-46c1-b0a4-9dedd4db7dea
 從插入的智慧卡取得的 PIN。
CPFG_CREDENTIAL_PROVIDER_LOGO
2d837775-f6cd-464e-a745-482fd0b47493
 Windows 8 中引進：用來代表登入頁面上認證提供者的映像。
CPFG_CREDENTIAL_PROVIDER_LABEL
286BBFF3-BAD4-438F-B007-79B7267C3D48
 Windows 8 中引進：與登入頁面上認證提供者相關聯的標籤。

備註

在磚上呈現給使用者的每個 UI 元素都會由認證提供者定義為欄位。 CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR是認證提供者識別欄位的方式。 為特定使用案例定義欄位後，就無法新增或從中減去欄位。 認證提供者必須先完整定義其所有欄位，才能列舉磚。 如果欄位將在認證取得程式中顯示或消失，則仍需要提前定義這些欄位。 視需要使用 CREDENTIAL_PROVIDER_FIELD_STATE 來隱藏或顯示欄位。

需求

Requirement 價值觀
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2008 [僅限傳統型應用程式]
Header credentialprovider.h
  • Last updated on