Método IFsiDirectoryItem::get__NewEnum (imapi2fs.h)
Recupera uma lista de itens filho contidos no diretório na imagem do sistema de arquivos.
Sintaxe
HRESULT get__NewEnum(
[out] IEnumVARIANT **NewEnum
);
Parâmetros
[out] NewEnum
Uma interface IEnumVariant que você usa para enumerar os itens filho contidos no diretório. Os itens da enumeração são variantes cujo tipo é VT_BSTR. Use o membro bstrVal para recuperar o caminho para o item filho.
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:
| Código de retorno | Descrição |
|---|---|
|
O ponteiro não é válido.
Valor: 0x80004003 |
|
Falha ao alocar a memória necessária.
Valor: 0x8007000E |
Comentários
A enumeração é uma instantâneo dos filhos contidos no diretório no momento da chamada e não refletirá os filhos adicionados e removidos.
Para recuperar um único item, consulte a propriedade IFsiDirectoryItem::get_Item .
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 |