Método IUrlAccessor::GetFileName (searchapi.h)

Recupera o nome do arquivo do item, que o host de filtro usa para indexação. Se o item não existir em um sistema de arquivos e o método IUrlAccessor::BindToStream for implementado, esse método retornará a propriedade System.ParsingPath do shell para o item.

Sintaxe

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

Parâmetros

[out] wszFileName

Tipo: WCHAR[]

Recebe o nome do arquivo como uma cadeia de caracteres Unicode terminada em nulo.

[in] dwSize

Tipo: DWORD

Tamanho em TCHARs de wszFileName, sem incluir o NULL de terminação.

[out] pdwLength

Tipo: DWORD*

Recebe um ponteiro para o número de TCHARgravadosem wszFileName, sem incluir NULL.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Se esse método for implementado, o host de filtro usará o nome do arquivo para determinar o IFilter correto a ser usado para analisar o conteúdo do fluxo retornado por IUrlAccessor::BindToStream.

Requisitos