Método IEnumVdsObject::Next (vdshwprv.h)

[Começando com Windows 8 e Windows Server 2012, a interface COM do Serviço de Disco Virtual é substituída pela API de Gerenciamento de Armazenamento do Windows.]

Retorna um número especificado de objetos na enumeração, começando do ponto atual. Para obter mais informações, consulte Trabalhando com objetos de enumeração.

Sintaxe

HRESULT Next(
  [in]  ULONG    celt,
  [out] IUnknown **ppObjectArray,
  [out] ULONG    *pcFetched
);

Parâmetros

[in] celt

O número de objetos a serem retornados.

[out] ppObjectArray

O endereço de uma matriz de ponteiros IUnknown , que o VDS inicializa no retorno.

[out] pcFetched

O endereço de um ULONG, que o VDS inicializa ao retornar ao número de objetos em ppObjectArray.

Retornar valor

Esse método pode retornar valores HRESULT padrão, como E_INVALIDARG ou E_OUTOFMEMORY, e valores retornados específicos do VDS. Ele também pode retornar códigos de erro do sistema convertidos usando a macro HRESULT_FROM_WIN32 . Os erros podem se originar do próprio VDS ou do provedor de VDS subjacente que está sendo usado. Os possíveis valores retornados incluem o seguinte.

Código de retorno	Descrição
S_OK	O método retornou o número especificado de objetos. O número de objetos retornados relatados em pcFetched é igual a celt; retorna esses objetos.
S_FALSE	O número especificado de objetos retornados é maior do que o número de objetos restantes. Todos os objetos restantes são retornados e o número de objetos retornados é relatado em pcFetched é menor que o celt; retorna esses objetos.

Comentários

Para obter ponteiros de interface específicos do objeto dos ponteiros IUnknown retornados na matriz ppObjectArray , use o método IUnknown::QueryInterface .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [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	vdshwprv.h
Biblioteca	Uuid.lib

Confira também

IEnumVdsObject