IUrlAccessor::GetFileName 方法 (searchapi.h)

检索筛选器主机用于索引的项的文件名。 如果文件系统中不存在该项,并且实现了 IUrlAccessor::BindToStream 方法,则此方法将返回该项的 shell 的 System.ParsingPath 属性。

语法

HRESULT GetFileName(
  [out] WCHAR [] wszFileName,
  [in]  DWORD    dwSize,
  [out] DWORD    *pdwLength
);

参数

[out] wszFileName

类型: WCHAR[]

以 null 结尾的 Unicode 字符串的形式接收文件名。

[in] dwSize

类型:DWORD

wszFileNameTCHAR 大小,不包括终止 NULL

[out] pdwLength

类型: DWORD*

接收指向写入 wszFileNameTCHAR指针,不包括 NULL

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

如果实现了此方法,筛选器主机将使用文件名来确定用于分析 IUrlAccessor::BindToStream 返回的流内容的正确 IFilter

要求

要求
最低受支持的客户端 Windows XP SP2、Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 SP1 [仅限桌面应用]
目标平台 Windows
标头 searchapi.h
可再发行组件 Windows 桌面搜索 (WDS) 3.0