IUrlAccessor::GetFileName-Methode (searchapi.h)

Ruft den Dateinamen des Elements ab, das der Filterhost für die Indizierung verwendet. Wenn das Element nicht in einem Dateisystem vorhanden ist und die IUrlAccessor::BindToStream-Methode implementiert ist, gibt diese Methode die System.ParsingPath-Eigenschaft der Shell für das Element zurück.

Syntax

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

Parameter

[out] wszFileName

Typ: WCHAR[]

Empfängt den Dateinamen als mit NULL endende Unicode-Zeichenfolge.

[in] dwSize

Art: DWORD

Größe in TCHARs von wszFileName, ohne den beendenden NULL-Wert.

[out] pdwLength

Typ: DWORD*

Empfängt einen Zeiger auf die Anzahl von TCHAR-Werten, die in wszFileName geschrieben wurden, ohne NULL.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn diese Methode implementiert ist, verwendet der Filterhost den Dateinamen, um den richtigen IFilter zu bestimmen, der verwendet werden soll, um den Inhalt des von IUrlAccessor::BindToStream zurückgegebenen Streams zu analysieren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	searchapi.h
Verteilbare Komponente	Windows Desktop Search (WDS) 3.0