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