Método IFsiNamedStreams::get_Item (imapi2fs.h)
Recupera um único fluxo nomeado associado a um arquivo na imagem do sistema de arquivos.
Sintaxe
HRESULT get_Item(
[in] LONG index,
[out, optional] IFsiFileItem2 **item
);
Parâmetros
[in] index
Esse valor indica a posição do fluxo nomeado dentro da coleção. O número de índice é baseado em zero, ou seja, o primeiro item está no local 0 da coleção.
[out, optional] item
Ponteiro para um ponteiro para um objeto IFsiFileItem2 que representa o fluxo nomeado na posição especificada pelo índice. Esse parâmetro será definido como NULL se o índice especificado não estiver dentro do limite da coleção.
Valor retornado
S_OK é retornado com êxito, mas outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro normalmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:
| Valor/código retornado | Descrição |
|---|---|
|
O ponteiro não é válido. |
|
O valor especificado para o parâmetro '%1!ls!' será inválido. |
Comentários
Se o número de índice for negativo ou fora do intervalo, esse método retornará o IMAPI_E_INVALID_PARAM.
Para buscar um enumerador IEnumVARIANT para todos os fluxos nomeados associados a um arquivo, use o método IFsiNamedStreams::get__NewEnum .
Esse método tem suporte no Windows Server 2003 com Service Pack 1 (SP1), Windows XP com Service Pack 2 (SP2) e Windows Vista por meio do Feature Pack do Windows para Armazenamento. Todos os recursos fornecidos por este pacote de atualização têm suporte nativo no Windows 7 e no Windows Server 2008 R2.
Requisitos
| Cliente mínimo com suporte | Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | imapi2fs.h |