Método IFsiNamedStreams::get_Item (imapi2fs.h)
Recupera una sola secuencia con nombre asociada a un archivo en la imagen del sistema de archivos.
Sintaxis
HRESULT get_Item(
[in] LONG index,
[out, optional] IFsiFileItem2 **item
);
Parámetros
[in] index
Este valor indica la posición de la secuencia con nombre dentro de la colección. El número de índice se basa en cero, es decir, el primer elemento está en la ubicación 0 de la colección.
[out, optional] item
Puntero a un puntero a un objeto IFsiFileItem2 que representa la secuencia con nombre en la posición especificada por el índice. Este parámetro se establece en NULL si el índice especificado no está dentro del límite de la colección.
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 o valor devuelto | Descripción |
|---|---|
|
El puntero no es válido. |
|
Valor especificado para el parámetro '%1!ls!' es no válido. |
Comentarios
Si el número de índice es negativo o está fuera del intervalo, este método devuelve el IMAPI_E_INVALID_PARAM.
Para capturar un enumerador IEnumVARIANT para todas las secuencias con nombre asociadas a un archivo, use el método IFsiNamedStreams::get__NewEnum .
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 |