Metodo IFsiDirectoryItem::get_Item (imapi2fs.h)

Articolo
02/27/2024

Recupera la directory o l'elemento file specificato dall'immagine del file system.

Sintassi

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

Parametri

[in] path

Stringa contenente il percorso dell'elemento da recuperare.

[out] item

Interfaccia IFsiItem della directory o dell'elemento file richiesto.

Valore restituito

S_OK viene restituito in caso di esito positivo, ma altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:

Codice restituito	Descrizione
IMAPI_E_INVALID_PATH	Percorso '%1!s!' è formato male o contiene caratteri non validi. Valore: 0xC0AAB110
E_POINTER	Puntatore non valido. Valore: 0x80004003
IMAPI_E_INVALID_PARAM	Il valore specificato per il parametro %1!ls! non è valido. Valore: 0xC0AAB101
IMAPI_E_ITEM_NOT_FOUND	Impossibile trovare l'elemento %1!ls! nella gerarchia FileSystemImage. Valore: 0xC0AAB118
E_OUTOFMEMORY	Impossibile allocare la memoria necessaria. Valore: 0x8007000E

Commenti

Per determinare se l'elemento è un elemento di file o un elemento di directory, chiamare il metodo IFsiItem::QueryInterface passando __uuidof(IFsiDirectoryItem ) come identificatore dell'interfaccia. Se la chiamata ha esito positivo, l'elemento è un elemento di directory; in caso contrario, l'elemento è un elemento di file.

Per enumerare tutti gli elementi figlio, chiamare il metodo IFsiDirectoryItem::get__NewEnum .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	imapi2fs.h

Vedi anche

IFsiDirectoryItem

IFsiFileItem

Condividi tramite