CryptSIPVerifyIndirectData function (mssip.h)

Article
02/22/2024

The CryptSIPVerifyIndirectData function validates the indirect hashed data against the supplied subject.

Syntax

BOOL CryptSIPVerifyIndirectData(
  [in] SIP_SUBJECTINFO   *pSubjectInfo,
  [in] SIP_INDIRECT_DATA *pIndirectData
);

Parameters

[in] pSubjectInfo

A pointer to a SIP_SUBJECTINFO structure that contains information about the message subject.

[in] pIndirectData

A pointer to a SIP_INDIRECT_DATA structure that contains information about the hashed subject information.

Return value

The return value is TRUE if the function succeeds; otherwise, FALSE.

If this function returns FALSE, additional error information can be obtained by calling the GetLastError function. GetLastError will return one of the following error codes.

Return code	Description
ERROR_INVALID_PARAMETER	One or more of the parameters are not valid.
TRUST_E_SUBJECT_FORM_UNKNOWN	The subject type is an unknown type.

Remarks

Subjects include, but are not limited to, portable executable images (.exe), cabinet (.cab) images, flat files, and catalog files. Each subject type uses a different subset of its data for hash calculation and requires a different procedure for storage and retrieval. Therefore each subject type has a unique subject interface package specification.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	mssip.h
Library	Crypt32.lib
DLL	Crypt32.dll

Share via