Compartilhar via

Método IEnumBstr::Next (tapi3if.h)

  • Artigo

O método Next obtém o próximo número especificado de elementos na sequência de enumeração. Esse método está oculto do Visual Basic e das linguagens de script.

Sintaxe

HRESULT Next(
  [in]      ULONG celt,
  [out]     BSTR  *ppStrings,
  [in, out] ULONG *pceltFetched
);

Parâmetros

[in] celt

Número de elementos solicitados.

[out] ppStrings

Ponteiro para a lista de ponteiros BSTR retornados.

[in, out] pceltFetched

Ponteiro para o número de elementos realmente fornecidos. Pode ser NULL se celt for um.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 O método retornou o número de elementos celt .
S_FALSE
 O número de elementos restantes era menor que celt.
E_POINTER
 O parâmetro ppStrings não é um ponteiro válido.

Comentários

O aplicativo deve usar SysFreeString para liberar a memória alocada para o parâmetro ppStrings .

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi3if.h (inclua Tapi3.h)
Biblioteca Uuid.lib
DLL Tapi3.dll