pfnIsFileSupportedName 回调函数 (mssip.h)

pfnIsFileSupportedName 回调函数查询注册表中列出的主题接口包 (SIP) ，以确定哪个 SIP 处理文件类型。

语法

pfnIsFileSupportedName Pfnisfilesupportedname;

BOOL Pfnisfilesupportedname(
  [in]  WCHAR *pwszFileName,
  [out] GUID *pgSubject
)
{...}

[in] pwszFileName

指向以 null 结尾的字符串的指针，该字符串包含 SIP 要处理的文件的绝对路径。

[out] pgSubject

标识处理文件类型的 SIP 的 GUID。

如果函数成功，则返回值为 TRUE ;如果函数失败，则为 FALSE 。如果函数失败，请调用 GetLastError 函数来确定失败的原因。

如果 SIP 支持 hfile 传递的文件类型，则函数将返回 TRUE，并将 pgSubject 设置为标识用于处理文件类型的 SIP 的 GUID。

每个 SIP 实现自己的函数版本，以确定文件类型是否受支持。函数的特定名称可能因 SIP 的实现而异，但函数的签名将与 SIP_ADD_NEWPROVIDER 结构的签名匹配。

SIP 必须支持有限的一组文件类型和文件扩展名。 fileSupportedName 函数必须检查所提供的文件与 SIP 支持的文件扩展名之一匹配。例如，WSH SIP 仅支持以下文件扩展名列表，并检查正在验证的文件是否为以下列表的成员：.js、.jse、.vbe、.vbs 或 .wsf。