次の方法で共有

IADsPropertyList::Next メソッド (iads.h)

  • [アーティクル]

IADsPropertyList::Next メソッドは、プロパティ リスト内の次の項目を取得します。 返される項目は、Property Entry オブジェクトです。

構文

HRESULT Next(
  [out] VARIANT *pVariant
);

パラメーター

[out] pVariant

プロパティ リスト内の次の項目の値を含む呼び出し元によって割り当てられた変数のアドレス。 VT_DISPATCHの戻り値は、IADsPropertyEntry インターフェイスを実装するオブジェクトへの IDispatch インターフェイス ポインターを参照します。

戻り値

このメソッドは、アイテムが取得された場合のS_OKを含む、標準の HRESULT 値をサポートします。 リスト内の最後の項目が返されるとき、返される戻り値は、使用されているプロバイダーによって異なります。 次のコードは、リスト内の最後の項目が取得されたことを示すために使用されます。

詳細およびその他の戻り値については、「 ADSI エラー コード」を参照してください。

解説

Next メソッドによって返される値が不要になった場合は、VariantClear を使用して pVariant をクリアする必要があります。

例

次のコード例は、 Next メソッドを使用してプロパティ リストを確認する方法を示しています。

Dim propList As IADsPropertyList
Dim v as Variant
Dim propVal As IADsPropertyValue
 
On Error Resume Next
 
Set propList = GetObject("LDAP://dc01/DC=Fabrikam,DC=com")
 
propList.GetInfo
Set v = propList.Next()
While (Not (IsNull(v)) And Err.Number = 0)
    Set propEnty = v
    Debug.Print v.Name
    Debug.Print v.AdsType
    
    Set v = propList.Next    
Wend

次の C++ コード例は、 IADsPropertyList::Next メソッドの 動作方法を示しています。

////////////////////////////////////
// Function used to retrieve an entry using the 
// IADsPropertyList::Next method.
 
//     name: GetNextEntry
//    input: IADsPropertyList*
//   return: IADsPropertyEntry
//     uses: IADsPropertyList::Next
/////////////////////////////////////////////////////////
IADsPropertyEntry* GetNextEntry(IADsPropertyList* pList)
{
    VARIANT var;
    VariantInit(&var);
    IADsPropertyEntry *pEntry;

    if(!pList)
    {
        _tprintf("An error has occurred.");
        return NULL;
    }
 
    HRESULT hr = pList->Next(&var);
    hr = V_DISPATCH(&var)->QueryInterface(IID_IADsPropertyEntry,
                                         (void**)&pEntry);
    VariantClear(&var);
    return pEntry;
}

要件

   
サポートされている最小のクライアント Windows Vista
サポートされている最小のサーバー Windows Server 2008
対象プラットフォーム Windows
ヘッダー iads.h
[DLL] Activeds.dll

関連項目

ADSI エラー コード

IADsPropertyEntry

IADsPropertyList

IADsPropertyList プロパティ メソッド

IDispatch