Compartilhar via

Método IVssEnumObject::Next (vss.h)

  • Artigo

O método Next retorna o número especificado de objetos da lista especificada de objetos enumerados.

Sintaxe

HRESULT Next(
  [in]  ULONG           celt,
  [out] VSS_OBJECT_PROP *rgelt,
  [out] ULONG           *pceltFetched
);

Parâmetros

[in] celt

O número de elementos a serem lidos da lista de objetos enumerados no buffer rgelt .

[out] rgelt

O endereço de um buffer alocado pelo chamador que recebe estruturas deVSS_OBJECT_PROP celt que contêm os objetos retornados. Esse parâmetro é necessário e não pode ser NULL.

[out] pceltFetched

O número de elementos que foram retornados no buffer rgelt .

Retornar valor

Veja a seguir os códigos de retorno válidos para esse método.

Valor Significado
S_OK
 A operação foi bem-sucedida.
S_FALSE
 O número de itens retornados é menor que o número solicitado.
E_FAIL
 Há um erro interno no enumerador.
E_POINTER
 Um dos parâmetros de ponteiro necessários é NULL.

Comentários

Ao solicitar o retorno de mais de um objeto VSS_OBJECT_PROP , um valor retornado de S_FALSE indica que o final da lista de enumeração foi atingido. Se mais objetos forem solicitados do que o restante na lista, Next retornará todos os objetos restantes, definirá o parâmetro pceltFetched como um valor diferente de zero e retornará S_FALSE.

O parâmetro rgelt de saída deve apontar para uma matriz alocada que contém estruturas decelt VSS_OBJECT_PROP e não pode ser NULL.

É responsabilidade do chamador liberar recursos do sistema retornados por IVssEnumObject::Avançar para a estrutura de VSS_OBJECT_PROP apontada pelo parâmetro rgelt .

Os chamadores devem usar CoTaskMemFree para cada valor de cadeia de caracteres no objeto VSS_SNAPSHOT_PROP ou VSS_PROVIDER_PROP na estrutura de VSS_OBJECT_PROP retornada.

No caso de VSS_SNAPSHOT_PROP, isso pode ser feito manualmente ou a função de utilitário VssFreeSnapshotProperties pode ser usada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [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 vss.h
Biblioteca VssApi.lib

Confira também

IVssBackupComponents::Query

IVssEnumObject

VSS_OBJECT_PROP