IADsPropertyList：：Next 方法 (iads.h)

發行項
08/24/2023

IADsPropertyList：：Next方法會取得屬性清單中的下一個專案。傳回的專案是 Property Entry 物件。

語法

HRESULT Next(
  [out] VARIANT *pVariant
);

參數

[out] pVariant

呼叫端配置的變數位址，其中包含屬性清單中的下一個專案值。 VT_DISPATCH的傳回值是指實作IADsPropertyEntry介面之物件的IDispatch介面指標。

傳回值

這個方法支援標準 HRESULT 值，包括 取得專案時S_OK 。傳回清單中的最後一個專案時，傳回的傳回值會根據使用的提供者而有所不同。下列程式碼可用來指出已取得清單中的最後一個專案：

如需詳細資訊和其他傳回值，請參閱 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;
}