Método IFsiNamedStreams::get__NewEnum (imapi2fs.h)
Recupera uma lista IEnumVARIANT dos fluxos nomeados associados a um arquivo na imagem do sistema de arquivos.
Sintaxe
HRESULT get__NewEnum(
[out, optional] IEnumVARIANT **NewEnum
);
Parâmetros
[out, optional] NewEnum
Ponteiro para um ponteiro para uma interface IEnumVariant que é usada para enumerar os fluxos nomeados associados a um arquivo. Os itens da enumeração são variantes cujo tipo é VT_BSTR. Use o membro bstrVal para recuperar o caminho para o fluxo nomeado.
Valor retornado
S_OK é retornado quando o número de elementos solicitados (celt) é retornado com êxito ou o número de itens retornados (pceltFetched) é menor que o número de elementos solicitados. Os parâmetros celt e pceltFetched são definidos por IEnumVariant.
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. |
|
Falha ao alocar a memória necessária. |
Comentários
A enumeração é uma instantâneo dos fluxos nomeados associados ao arquivo no momento da chamada e não refletirá fluxos nomeados adicionados ou removidos posteriormente.
Para recuperar um único fluxo nomeado, use o método IFsiNamedStreams::get_Item .
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 |