共用方式為

CryptSIPGetSignedDataMsg 函式 (mssip.h)

  • 發行項

CryptSIPGetSignedDataMsg 函式會從檔案擷取 Authenticode 簽章。

語法

BOOL CryptSIPGetSignedDataMsg(
  [in]      SIP_SUBJECTINFO *pSubjectInfo,
  [out]     DWORD           *pdwEncodingType,
  [in]      DWORD           dwIndex,
  [in, out] DWORD           *pcbSignedDataMsg,
  [out]     BYTE            *pbSignedDataMsg
);

參數

[in] pSubjectInfo

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

[out] pdwEncodingType

Authenticode 簽章的編碼類型。

此參數可以是下列一或多個值的組合。

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

[in] dwIndex

此參數是保留的，而且應該設定為零。

[in, out] pcbSignedDataMsg

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

[out] pbSignedDataMsg

要接收傳回 Authenticode 簽章之緩衝區的指標。

若要判斷所需的緩衝區大小，請將 pbSignedDataMsg 參數設定為 NULL ，並呼叫 CryptSIPGetSignedDataMsg 函 式。 此函式會將緩衝區的必要大小，以位元組為單位，放在 由其所指向的值中，以位元組為單位。 如需詳細資訊，請參閱 擷取未知長度的數據。

傳回值

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

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

傳回碼 Description
CRYPT_E_NO_MATCH
 找不到索引所指定的簽章。
ERROR_BAD_FORMAT
 主旨介面套件的指定資料或檔案格式 (SIP) 無效。
ERROR_INVALID_PARAMETER
 [SIP_SUBJECTINFO] (/windows/desktop/api/mssip/ns-mssip-sip_subjectinfo) 結構是 null 指標。
ERROR_INSUFFICIENT_BUFFER
 訊息緩衝區的大小不足，無法保存擷取的數據， 已設定為表示 所需的緩衝區大小。
TRUST_E_SUBJECT_FORM_UNKNOWN
 指定的主旨類型無效。

備註

主旨包括但不限於可攜式可執行檔映像 (.exe) 、封包 (.cab) 影像、一般檔案和類別目錄檔案。 每個主體類型都會使用不同的數據子集進行哈希計算，而且需要不同的程式來儲存和擷取。 因此，每個主體類型都有唯一的 SIP 規格。

規格需求

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

另請參閱

CryptSIPPutSignedDataMsg

CryptSIPRemoveSignedDataMsg