SIP_DISPATCH_INFO 结构 (mssip.h)

项目
03/05/2024

SIP_DISPATCH_INFO 结构包含一组由 CryptSIPLoad 函数分配的函数指针，应用程序使用这些指针来执行主题接口包 (SIP) 操作。

语法

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;

成员

cbSize

此结构的大小（以字节为单位）。

hSIP

此成员是保留成员，必须设置为 NULL。

pfGet

指向检索主题的已签名数据的函数的指针。 CryptSIPGetSignedDataMsg 中介绍了此函数指针的签名。

pfPut

指向存储主题的已签名数据的函数的指针。 CryptSIPPutSignedDataMsg 中介绍了此函数指针的签名。

pfCreate

指向函数的指针，该函数返回包含主题数据的 SIP_INDIRECT_DATA 结构。此结构包含目标的哈希。 CryptSIPCreateIndirectData 中介绍了此函数指针的签名。

pfVerify

指向函数的指针，该函数验证包含主题数据的 SIP_INDIRECT_DATA 结构。此结构包含目标的哈希。 CryptSIPVerifyIndirectData 中介绍了此函数指针的签名。

pfRemove

指向函数的指针，该函数删除主题的已签名数据。 CryptSIPRemoveSignedDataMsg 中介绍了此函数指针的签名。

注解

应用程序必须将此结构初始化为二进制零，并通过调用 memset 函数将 cbSize 设置为 sizeof(SIP_DISPATCH_INFO) ，然后再调用 CryptSIPLoad 函数。应用程序可以使用返回的 SIP_DISPATCH_INFO 结构中的函数指针来执行必要的 SIP 操作。函数指针可以指向由第三方 SIP 导出的函数。