Metodo IFsiNamedStreams::get__NewEnum (imapi2fs.h)
Recupera un elenco IEnumVARIANT dei flussi denominati associati a un file nell'immagine del file system.
Sintassi
HRESULT get__NewEnum(
[out, optional] IEnumVARIANT **NewEnum
);
Parametri
[out, optional] NewEnum
Puntatore a un puntatore a un'interfaccia IEnumVariant usata per enumerare i flussi denominati associati a un file. Gli elementi dell'enumerazione sono varianti il cui tipo è VT_BSTR. Usare il membro bstrVal per recuperare il percorso del flusso denominato.
Valore restituito
S_OK viene restituito quando il numero di elementi richiesti (celt) viene restituito correttamente o il numero di elementi restituiti (pceltFetched) è minore del numero di elementi richiesti. I parametri celt e pceltFetched sono definiti da IEnumVariant.
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. |
|
Impossibile allocare la memoria richiesta. |
Commenti
L'enumerazione è uno snapshot dei flussi denominati associati al file al momento della chiamata e non rifletterà i flussi denominati aggiunti o rimossi in un secondo momento.
Per recuperare un singolo flusso denominato, usare il metodo IFsiNamedStreams::get_Item .
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 |