ITCollection::get__NewEnum メソッド (tapi3if.h)

get__NewEnum メソッドは、コレクションの列挙子を取得します。

構文

HRESULT get__NewEnum(
  [out] IUnknown **ppNewEnum
);

パラメーター

[out] ppNewEnum

コレクションの列挙子オブジェクトの IUnknown インターフェイスへのポインター。

返された IUnknown インターフェイスで QueryInterface メソッドを呼び出して、コレクションの IEnumVARIANT 列挙インターフェイスへのポインターを取得します。 IEnumVARIANT には、コレクションを反復処理するために使用できるさまざまなメソッドが用意されています。

詳細については、「解説」を参照してください。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード	説明
S_OK	メソッドが成功しました。
E_OUTOFMEMORY	操作を実行するためのメモリが不足しています。

解説

コレクションを返すメソッドを含む各 TAPI 3 インターフェイスには、TAPI 3 列挙子インターフェイスへのポインターを返すメソッドも含まれています。 C/C++ でプログラミングする場合は、 ITCollection::get__NewEnum メソッドを呼び出す代わりに、コレクションの列挙子メソッドを直接呼び出して列挙子オブジェクトを取得する方が簡単です。 たとえば、 ITTAPI::EnumerateAddresses メソッドは IEnumAddress インターフェイスへのポインターを返します。 IEnumAddress には、Address オブジェクトの列挙メソッドが用意されています。

Visual Basic でプログラミングする場合は、コレクションを列挙するためにこのメソッドを呼び出す必要はありません。 これは、 For..を使用してメソッドの機能を暗黙的に呼び出すことができるためです。各。。。インチ。。。次に。。。 構築。

要件

対象プラットフォーム	Windows
ヘッダー	tapi3if.h (Tapi3.h を含む)
Library	Uuid.lib
[DLL]	Tapi3.dll

関連項目

ITCollection