Skip to main content
SIP_DISPATCH_INFO structure

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, *PSIP_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

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