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 |