Compartilhar via

Método IFsiDirectoryItem::get_Item (imapi2fs.h)

  • Artigo

Recupera o diretório ou o item de arquivo especificado da imagem do sistema de arquivos.

Sintaxe

HRESULT get_Item(
  [in]  BSTR     path,
  [out] IFsiItem **item
);

Parâmetros

[in] path

Cadeia de caracteres que contém o caminho para o item a ser recuperado.

[out] item

Uma interface IFsiItem do diretório ou item de arquivo solicitado.

Retornar valor

S_OK é retornado com êxito, mas outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro normalmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:

Código de retorno Descrição
IMAPI_E_INVALID_PATH
 Caminho '%1!s!' é mal formado ou contém caracteres inválidos.

Valor: 0xC0AAB110
E_POINTER
 O ponteiro não é válido.

Valor: 0x80004003
IMAPI_E_INVALID_PARAM
 O valor especificado para o parâmetro %1!ls! não é válido.

Valor: 0xC0AAB101
IMAPI_E_ITEM_NOT_FOUND
 Não é possível localizar o item %1!ls! na hierarquia FileSystemImage.

Valor: 0xC0AAB118
E_OUTOFMEMORY
 Falha ao alocar a memória necessária.

Valor: 0x8007000E

Comentários

Para determinar se o item é um item de arquivo ou item de diretório, chame o método IFsiItem::QueryInterface passando __uuidof(IFsiDirectoryItem) como o identificador de interface. Se a chamada for bem-sucedida, o item será um item de diretório; caso contrário, o item é um item de arquivo.

Para enumerar todos os filhos, chame o método IFsiDirectoryItem::get__NewEnum .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho imapi2fs.h

Confira também

IFsiDirectoryItem

IFsiFileItem