Metodo IFsiNamedStreams::get_Item (imapi2fs.h)
Recupera un singolo flusso denominato associato a un file nell'immagine del file system.
Sintassi
HRESULT get_Item(
[in] LONG index,
[out, optional] IFsiFileItem2 **item
);
Parametri
[in] index
Questo valore indica la posizione del flusso denominato all'interno della raccolta. Il numero di indice è basato su zero, ad esempio il primo elemento si trova nella posizione 0 della raccolta.
[out, optional] item
Puntatore a un puntatore a un oggetto IFsiFileItem2 che rappresenta il flusso denominato nella posizione specificata dall'indice. Questo parametro è impostato su NULL se l'indice specificato non rientra nel limite della raccolta.
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/valore restituito | Descrizione |
|---|---|
|
Puntatore non valido. |
|
Valore specificato per il parametro '%1!ls!' non è valido. |
Commenti
Se il numero di indice è negativo o non compreso nell'intervallo, questo metodo restituisce il IMAPI_E_INVALID_PARAM.
Per recuperare un enumeratore IEnumVARIANT per tutti i flussi denominati associati a un file, usare il metodo IFsiNamedStreams::get__NewEnum .
Questo metodo è supportato in Windows Server 2003 con Service Pack 1 (SP1), Windows XP con Service Pack 2 (SP2) e Windows Vista tramite Windows Feature Pack per l'archiviazione. Tutte le funzionalità fornite da questo pacchetto di aggiornamento sono supportate in modo nativo in Windows 7 e Windows Server 2008 R2.
Requisiti
| 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 |