CryptSIPPutSignedDataMsg 函式 (mssip.h)

  • 發行項

CryptSIPPutSignedDataMsg 函式會將 Authenticode 簽章儲存在目標檔案中。

語法

BOOL CryptSIPPutSignedDataMsg(
  [in]  SIP_SUBJECTINFO *pSubjectInfo,
  [in]  DWORD           dwEncodingType,
  [out] DWORD           *pdwIndex,
  [in]  DWORD           cbSignedDataMsg,
  [in]  BYTE            *pbSignedDataMsg
);

參數

[in] pSubjectInfo

包含訊息主旨相關信息 之SIP_SUBJECTINFO 結構的指標。

[in] dwEncodingType

訊息的編碼類型。 這可以是下列一或多個值的組合。

值 意義
PKCS_7_ASN_ENCODING
65536 (0x10000)
指定 PKCS #7 訊息編碼。
X509_ASN_ENCODING
1 (0x1)
指定 X.509 憑證編碼。

[out] pdwIndex

訊息索引的指標。

[in] cbSignedDataMsg

pbSignedDataMsg 參數所指向緩衝區的長度，以位元組為單位。

[in] pbSignedDataMsg

包含訊息之緩衝區的指標。

傳回值

如果函式成功，函式會傳回 TRUE。

如果函式失敗，則會傳回 FALSE。 如需擴充的錯誤資訊，請呼叫 GetLastError。 接下來有一些可能的錯誤碼。

傳回碼 Description
ERROR_BAD_FORMAT
 主旨介面套件的指定資料或檔案格式 (SIP) 無效。
ERROR_INVALID_PARAMETER
 基於下列原因，可以傳回此程序代碼：
  • pSubjectInfo 為 NULL。
  • pdwIndex 為 NULL。
  • pbSignedDataMsg 為 NULL。
  • cbSignedDataMsg 參數的值小於一。
    • [SIP_SUBJECTINFO] (/windows/desktop/api/mssip/ns-mssip-sip_subjectinfo) 結構。 [SIP_SUBJECTINFO] (/windows/desktop/api/mssip/ns-mssip-sip_subjectinfo) 結構。
TRUST_E_SUBJECT_FORM_UNKNOWN
 指定的主旨類型無效。

備註

每個主體類型都會使用不同的數據子集進行哈希計算，而且需要不同的程式來儲存和擷取。 因此，每個主體類型都有唯一的 SIP 規格。

規格需求

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

另請參閱

CryptSIPGetSignedDataMsg

CryptSIPRemoveSignedDataMsg