Método IFsiNamedStreams::get__NewEnum (imapi2fs.h)
Recupera una lista IEnumVARIANT de las secuencias con nombre asociadas a un archivo en la imagen del sistema de archivos.
Sintaxis
HRESULT get__NewEnum(
[out, optional] IEnumVARIANT **NewEnum
);
Parámetros
[out, optional] NewEnum
Puntero a un puntero a una interfaz IEnumVariant que se usa para enumerar las secuencias con nombre asociadas a un archivo. Los elementos de la enumeración son variantes cuyo tipo es VT_BSTR. Use el miembro bstrVal para recuperar la ruta de acceso a la secuencia con nombre.
Valor devuelto
S_OK se devuelve cuando el número de elementos solicitados (celt) se devuelve correctamente o el número de elementos devueltos (pceltFetched) es menor que el número de elementos solicitados. Los parámetros celt y pceltFetched se definen mediante IEnumVariant.
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 o valor devuelto | Descripción |
|---|---|
|
El puntero no es válido. |
|
No se pudo asignar la memoria necesaria. |
Comentarios
La enumeración es una instantánea de las secuencias con nombre asociadas al archivo en el momento de la llamada y no reflejará las secuencias con nombre que se agregan o quitan más adelante.
Para recuperar una sola secuencia con nombre, use el método IFsiNamedStreams::get_Item .
Este método se admite en Windows Server 2003 con Service Pack 1 (SP1), Windows XP con Service Pack 2 (SP2) y Windows Vista a través de Windows Feature Pack para Storage. Todas las características proporcionadas por este paquete de actualización se admiten de forma nativa en Windows 7 y Windows Server 2008 R2.
Requisitos
| 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 |