共用方式為

CRYPTUI_WIZ_DIGITAL_SIGN_INFO結構 (cryptuiapi.h)

  • 發行項

[ CRYPTUI_WIZ_DIGITAL_SIGN_INFO 結構可用於需求一節中指定的操作系統。 後續版本可能會變更或無法使用。]

CRYPTUI_WIZ_DIGITAL_SIGN_INFO 結構包含數位簽名的相關信息。 CryptUIWizDigitalSign 函式會使用此結構。

語法

typedef struct _CRYPTUI_WIZ_DIGITAL_SIGN_INFO {
  DWORD                                    dwSize;
  DWORD                                    dwSubjectChoice;
  union {
    LPCWSTR                              pwszFileName;
    PCCRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO pSignBlobInfo;
  };
  DWORD                                    dwSigningCertChoice;
  union {
    PCCERT_CONTEXT                           pSigningCertContext;
    PCCRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO    pSigningCertStore;
    PCCRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO pSigningCertPvkInfo;
  };
  LPCWSTR                                  pwszTimestampURL;
  DWORD                                    dwAdditionalCertChoice;
  PCCRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO pSignExtInfo;
} CRYPTUI_WIZ_DIGITAL_SIGN_INFO, *PCRYPTUI_WIZ_DIGITAL_SIGN_INFO;

成員

dwSize

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

dwSubjectChoice

值，表示要簽署的實體。 如果在 CryptUIWizDigitalSign 函式的 dwFlags 參數中指定了CRYPTUI_WIZ_NO_UI，則需要此成員。 這可以是下列其中一個值。

值 意義
CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOB
 要簽署 pSignBlobInfo 成員所指定的記憶體 BLOB。
CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILE
 要簽署 pwszFileName 成員所指定的檔案。
0
 系統會提示使用者簽署檔案。

pwszFileName

Null 終止 Unicode 字串的指標，其中包含要簽署之檔案的路徑和檔名。 如果為 dwSubjectChoice 成員指定CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILE，則會使用此成員。

pSignBlobInfo

包含要簽署之 BLOB 之CRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO 結構的指標。 如果為 dwSubjectChoice 成員指定CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOB，則會使用此成員。

dwSigningCertChoice

值，指定用來簽署實體的憑證位置。 預設值為零。 這可以是下列其中一個值。

注意如果在 CryptUIWizDigitalSign 函式的 dwFlags 參數中指定CRYPTUI_WIZ_NO_UI，這個值必須CRYPTUI_WIZ_DIGITAL_SIGN_CERT或CRYPTUI_WIZ_DIGITAL_SIGN_PVK。
 
值 意義
CRYPTUI_WIZ_DIGITAL_SIGN_CERT
 憑證包含在 pSigningCertContext 成員所指向的CERT_CONTEXT結構中。
CRYPTUI_WIZ_DIGITAL_SIGN_STORE
 憑證包含在 pSigningCertStore 成員所指向之CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO結構的證書存儲中。
CRYPTUI_WIZ_DIGITAL_SIGN_PVK
 憑證包含在 pSigningCertPvkInfo 成員所指向之CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO結構中的 PVK 檔案中。
0
 使用 「我的存放區」中的憑證。

pSigningCertContext

CERT_CONTEXT 結構的指標，其中包含用來簽署實體的憑證。 如果為 dwSigningCertChoice 成員指定了CRYPTUI_WIZ_DIGITAL_SIGN_CERT，則會使用此成員。

pSigningCertStore

CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO 結構的指標，其中包含用來簽署實體的憑證。 如果為 dwSigningCertChoice 成員指定了CRYPTUI_WIZ_DIGITAL_SIGN_STORE，則會使用此成員。

pSigningCertPvkInfo

包含用來簽署實體之憑證 之CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO 結構的指標。 如果為 dwSigningCertChoice 成員指定了CRYPTUI_WIZ_DIGITAL_SIGN_PVK，則會使用此成員。

pwszTimestampURL

Null 終止 Unicode 字串的指標，其中包含時間戳的 URL。

dwAdditionalCertChoice

值，指出簽章中是否要包含其他憑證。 預設值為零。 這可以是下列其中一個值。

值 意義
CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN
 整個憑證鏈結將會包含在簽章中。
CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN_NO_ROOT
 除了根目錄以外，憑證鏈結中的所有憑證都會包含在簽章中。
0
 簽章中不會包含其他憑證。

pSignExtInfo

包含簽章擴充資訊的 CRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO 結構的指標。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
標頭 cryptuiapi.h

另請參閱

CryptUIWizDigitalSign