GetFilter 方法

按照提供的参数获取适当的筛选器。

HRESULT GetFilter(
CLSID *pclsidObj,
LPCWSTR pcwszContentType,
LPCWSTR pcwszExtension,
IFilter **ppFilter
);

Parameters

pclsidObj

[输入] 指向注册表中文档类型的类 ID (CLSID) 的指针。此指针指示用于项目中的嵌入式文档的适当筛选器。

pcwszContentType

[输入] 指向包含文档类型并以 NULL 结尾的 Unicode 字符串的指针。此指针用于检索按照多用途 Internet 邮件扩展 (MIME) 类型进行映射的筛选器。

pcwszExtension

[输入] 指向包含文件扩展名（无前面的句点）并以 NULL 结尾的 Unicode 字符串的指针。此指针用于检索映射到指定的文件扩展名的筛选器。

ppFilter

[输出] 指向协议处理程序使用的筛选器的指针的地址。

如果成功，则返回 S_OK，否则返回错误值。有关 Microsoft Office SharePoint Server 2007 企业级搜索返回的错误消息的列表，请参阅协议处理程序错误消息。

如果协议处理程序需要某个嵌入式文档的筛选器，它可以通过调用此方法获取此筛选器。此方法查询筛选器端口监控程序，以获取适用于内容项的筛选器。

选择筛选器的依据是：文件扩展名、在注册表中标识文件内容的 CLSID，或者 MIME 内容类型。只能提供这三个参数之一。如果提供多个参数，则按下列顺序试验这些参数：

此方法使用第一个有效的参数来选择适当的筛选器，并忽略其他参数。