IUrlAccessor：：GetFileName 方法 (searchapi.h)

擷取篩選主機用於編製索引的項目檔名。 如果專案不存在於文件系統中，且實作 IUrlAccessor：：BindToStream 方法，這個方法會傳回專案的殼層 System.ParsingPath 屬性。

語法

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

參數

[out] wszFileName

類型： WCHAR[]

以 Null 終止的 Unicode 字串的形式接收檔名。

[in] dwSize

類型： DWORD

wszFileName 的 TCHARs 大小，不包括終止 NULL。

[out] pdwLength

類型： DWORD*

接收寫入wszFileName 之 TCHAR 數目的指標，不包括 NULL。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

如果實作此方法，篩選主機會使用檔名來判斷正確的 IFilter ，以剖析 IUrlAccessor：：BindToStream 傳回的數據流內容。

規格需求