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;

成員

dwFieldID

類型： DWORD

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

cpft

類型： CREDENTIAL_PROVIDER_FIELD_TYPE

欄位型別 (Field Type)。

pszLabel

類型： LPWSTR

緩衝區的指標，其中包含欄位的易記名稱，做為 Null 終止的 Unicode 字串。 這用於協助工具和佇列用途。 例如，某些標準欄位會有 「Username」、「Password」 和 「Log On To」 的 Friend 名稱。

guidFieldType

類型： GUID

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

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

值 意義
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 視需要隱藏或顯示欄位。

規格需求

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