CryptUIDlgSelectCertificateFromStore 函式 (cryptuiapi.h)

  • 發行項

CryptUIDlgSelectCertificateFromStore 函式會顯示對話框，允許從指定的存放區選取憑證。

語法

PCCERT_CONTEXT CryptUIDlgSelectCertificateFromStore(
  [in]           HCERTSTORE hCertStore,
  [in]           HWND       hwnd,
  [in, optional] LPCWSTR    pwszTitle,
  [in, optional] LPCWSTR    pwszDisplayString,
  [in]           DWORD      dwDontUseColumn,
  [in]           DWORD      dwFlags,
  [in]           void       *pvReserved
);

參數

[in] hCertStore

要搜尋的證書存儲句柄。

[in] hwnd

顯示視窗的句柄。 如果 為 NULL，則預設為桌面視窗。

[in, optional] pwszTitle

用來做為對話框標題的字串。 如果 為 NULL，則會使用預設標題「選取憑證」。

[in, optional] pwszDisplayString

選取對話框中的 Text 語句。 如果 為 NULL，則會使用預設片語「選取您想要使用的憑證」。

[in] dwDontUseColumn

可以合併以排除顯示數據行的旗標。

值 意義
CRYPTUI_SELECT_ISSUEDTO_COLUMN
 請勿顯示ISSUEDTO資訊。
CRYPTUI_SELECT_ISSUEDBY_COLUMN
 請勿顯示ISSUEDBY資訊。
CRYPTUI_SELECT_INTENDEDUSE_COLUMN
 請勿顯示 IntendedUse 資訊。
CRYPTUI_SELECT_FRIENDLYNAME_COLUMN
 不顯示顯示名稱資訊。
CRYPTUI_SELECT_LOCATION_COLUMN
 請勿顯示位置資訊。
CRYPTUI_SELECT_EXPIRATION_COLUMN
 不要顯示到期資訊。

[in] dwFlags

目前未使用 ，且應設定為 0。

[in] pvReserved

保留供未來使用。

傳回值

傳回所選憑證內容的指標。 如果未選取憑證，則會傳回 NULL 。 當您使用憑證完成時，請呼叫 CertFreeCertificateContext 函式來釋出憑證內容。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 cryptuiapi.h
程式庫 Cryptui.lib
Dll Cryptui.dll

另請參閱

CryptUIDlgViewContext