共用方式為

CRYPTUI_SELECTCERTIFICATE_STRUCT 結構

  • 發行項

CRYPTUI_SELECTCERTIFICATE_STRUCT結構包含CryptUIDlgSelectCertificate函式所顯示之對話方塊的相關資訊。

語法

typedef struct _CRYPTUI_SELECTCERTIFICATE_STRUCT {
  DWORD               dwSize;
  HWND                hwndParent;
  DWORD               dwFlags;
  LPCTSTR             szTitle;
  DWORD               dwDontUseColumn;
  LPCTSTR             szDisplayString;
  PFNCFILTERPROC      pFilterCallback;
  PFNCCERTDISPLAYPROC pDisplayCallback;
  void                *pvCallbackData;
  DWORD               cDisplayStores;
  HCERTSTORE          *rghDisplayStores;
  DWORD               cStores;
  HCERTSTORE          *rghStores;
  DWORD               cPropSheetPages;
  LPCPROPSHEETPAGE    rgPropSheetPages;
  HCERTSTORE          hSelectedCertStore;
} CRYPTUI_SELECTCERTIFICATE_STRUCT, *PCRYPTUI_SELECTCERTIFICATE_STRUCT;

成員

dwSize

這個結構的大小，以位元組為單位。

hwndParent

對話方塊之父視窗的控制碼。 如果此值為 Null，父視窗是預設桌面視窗。

dwFlags

指定 CryptUIDlgSelectCertificate 函式的其他選項。 這可以是零或位 OR 的下列值。

值 意義
CRYPTUI_SELECTCERT_ADDFROMDS
 保留的。
CRYPTUI_SELECTCERT_LEGACY
 指定要顯示舊版對話方塊。
CRYPTUI_SELECTCERT_MULTISELECT
 允許使用者在對話方塊中選取多個憑證。 如果設定此旗標， CryptUIDlgSelectCertificate 函式一律會傳回 Null。 這個結構的 hSelectedCertStore 成員必須包含憑證存放區的控制碼。 使用者選取的憑證將會新增至此存放區。
CRYPTUI_SELECTCERT_PUT_WINDOW_TOPMOST
 強制密碼編譯 UI 成為螢幕上的頂端視窗。

 

szTitle

對話方塊的顯示標題。 如果這個成員的值是 Null，則會使用 「選取憑證」的預設標題。

dwDontUseColumn

可以合併以排除顯示資料行的旗標。

值 意義
CRYPTUI_SELECT_ISSUEDTO_COLUMN
1 (0x1)
不顯示 ISSUEDTO 資訊。
CRYPTUI_SELECT_ISSUEDBY_COLUMN
2 (0x2)
不要顯示 ISSUEDBY 資訊。
CRYPTUI_SELECT_INTENDEDUSE_COLUMN
4 (0x4)
請勿顯示 IntendedUse 資訊。
CRYPTUI_SELECT_FRIENDLYNAME_COLUMN
8 (0x8)
不要顯示名稱資訊。
CRYPTUI_SELECT_LOCATION_COLUMN
16 (0x10)
請勿顯示位置資訊。
CRYPTUI_SELECT_EXPIRATION_COLUMN
32 (0x20)
不要顯示到期資訊。

 

szDisplayString

顯示在對話方塊中的文字，以指示使用者。 如果這個成員的值是 Null，則會使用預設字串「選取您想要使用的憑證」。

pFilterCallback

PFNCFILTERPROC回呼函式的指標，可篩選對話方塊中顯示的憑證。

pDisplayCallback

PFNCCERTDISPLAYPROC回呼函式的指標，顯示使用者選取要檢視的憑證。

pvCallbackData

傳遞至 pFilterCallback 和 pDisplayCallback 成員所指定回呼函式的其他資料。

cDisplayStores

rghDisplayStores陣列中的憑證存放區數目。

rghDisplayStores

存放區陣列的指標，其中包含對話方塊中可供選取的憑證。

cStores

rghStores陣列中的憑證存放區數目。

rghStores

建立憑證鏈結時要搜尋之憑證存放區陣列的指標，以及驗證對話方塊中所顯示之憑證的信任。

cPropSheetPages

rgPropSheetPages陣列中的屬性頁數。

rgPropSheetPages

PROPSHEETPAGE結構的陣列指標，代表選取憑證以供檢視時傳遞至憑證檢視對話方塊的屬性頁。

hSelectedCertStore

呼叫端所建立之憑證存放區的控制碼。 使用者選取的憑證會新增至此存放區。 如果此存放區中的憑證數目在呼叫 CryptUIDlgSelectCertificate之前和之後相同，使用者就會關閉對話方塊，而不選取任何憑證。

如果這個結構的 dwFlags 成員不包含 CRYPTUI_SELECTCERT_MULTISELECT 旗標，則不會使用此成員。

規格需求

需求 值
最低支援的用戶端
 Windows XP [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2003 [僅限桌面應用程式]
Unicode 與 ANSI 名稱
 CRYPTUI_SELECTCERTIFICATE_STRUCTW (Unicode ) 和 CRYPTUI_SELECTCERTIFICATE_STRUCTA (ANSI)

另請參閱

CryptUIDlgSelectCertificate