Compartir a través de

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

  • Artículo

Recupera el directorio o elemento de archivo especificado de la imagen del sistema de archivos.

Sintaxis

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

Parámetros

[in] path

Cadena que contiene la ruta de acceso al elemento que se va a recuperar.

[out] item

Interfaz IFsiItem del directorio o elemento de archivo solicitados.

Valor devuelto

S_OK se devuelve correctamente, pero se pueden devolver otros códigos de éxito como resultado de la implementación. Los siguientes códigos de error se devuelven normalmente en caso de error de operación, pero no representan los únicos valores de error posibles:

Código devuelto Descripción
IMAPI_E_INVALID_PATH
 Ruta de acceso '%1!s!' tiene un formato incorrecto o contiene caracteres no válidos.

Valor: 0xC0AAB110
E_POINTER
 El puntero no es válido.

Valor: 0x80004003
IMAPI_E_INVALID_PARAM
 El valor especificado para el parámetro %1!ls! no es válido.

Valor: 0xC0AAB101
IMAPI_E_ITEM_NOT_FOUND
 No se encuentra el elemento %1!ls! en la jerarquía FileSystemImage.

Valor: 0xC0AAB118
E_OUTOFMEMORY
 No se pudo asignar la memoria necesaria.

Valor: 0x8007000E

Comentarios

Para determinar si el elemento es un elemento de archivo o un elemento de directorio, llame al método IFsiItem::QueryInterface pasando __uuidof(IFsiDirectoryItem) como identificador de interfaz. Si la llamada se realiza correctamente, el elemento es un elemento de directorio; de lo contrario, el elemento es un elemento de archivo.

Para enumerar todos los elementos secundarios, llame al método IFsiDirectoryItem::get__NewEnum .

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado imapi2fs.h

Consulte también

IFsiDirectoryItem

IFsiFileItem