SIP_DISPATCH_INFO structure (mssip.h)

The SIP_DISPATCH_INFO structure contains a set of function pointers assigned by the CryptSIPLoad function that your application uses to perform subject interface package (SIP) operations.

Syntax

typedef struct SIP_DISPATCH_INFO_ {
  DWORD                        cbSize;
  HANDLE                       hSIP;
  pCryptSIPGetSignedDataMsg    pfGet;
  pCryptSIPPutSignedDataMsg    pfPut;
  pCryptSIPCreateIndirectData  pfCreate;
  pCryptSIPVerifyIndirectData  pfVerify;
  pCryptSIPRemoveSignedDataMsg pfRemove;
} SIP_DISPATCH_INFO, *LPSIP_DISPATCH_INFO;

Members

cbSize

The size, in bytes, of this structure.

hSIP

This member is reserved and must be set to NULL.

pfGet

A pointer to the function that retrieves the signed data for the subject. The signature for this function pointer is described in CryptSIPGetSignedDataMsg.

pfPut

A pointer to the function that stores the signed data for the subject. The signature for this function pointer is described in CryptSIPPutSignedDataMsg.

pfCreate

A pointer to the function that returns a SIP_INDIRECT_DATA structure that contains the subject data. This structure contains the hash of the target. The signature for this function pointer is described in CryptSIPCreateIndirectData.

pfVerify

A pointer to the function that verifies the SIP_INDIRECT_DATA structure that contains the subject data. This structure contains the hash of the target. The signature for this function pointer is described in CryptSIPVerifyIndirectData.

pfRemove

A pointer to the function that removes the signed data for the subject. The signature for this function pointer is described in CryptSIPRemoveSignedDataMsg.

Remarks

Your application must initialize this structure to binary zeros and set cbSize to sizeof(SIP_DISPATCH_INFO) by calling the memset function before calling the CryptSIPLoad function. Your application can use the function pointers in the returned SIP_DISPATCH_INFO structure to perform the necessary SIP operations. The function pointers can point to functions exported by third party SIPs.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header mssip.h

See also

CryptSIPCreateIndirectData

CryptSIPGetSignedDataMsg

CryptSIPPutSignedDataMsg

CryptSIPRemoveSignedDataMsg

CryptSIPVerifyIndirectData