IADsPropertyList::Next 메서드(iads.h)

아티클
08/24/2023

IADsPropertyList::Next 메서드는 속성 목록의 다음 항목을 가져옵니다. 반환된 항목은 Property Entry 개체입니다.

구문

HRESULT Next(
  [out] VARIANT *pVariant
);

매개 변수

[out] pVariant

속성 목록에서 다음 항목의 값을 포함하는 호출자가 할당한 변수의 주소입니다. VT_DISPATCH 반환 값은 IADsPropertyEntry 인터페이스를 구현하는 개체에 대한 IDispatch 인터페이스 포인터를 나타냅니다.

반환 값

이 메서드는 항목을 가져온 경우 S_OK 포함하여 표준 HRESULT 값을 지원합니다. 목록의 마지막 항목이 반환되면 반환되는 반환 값은 사용되는 공급자에 따라 달라집니다. 다음 코드는 목록의 마지막 항목을 얻었음을 나타내는 데 사용됩니다.

자세한 내용 및 기타 반환 값은 ADSI 오류 코드를 참조하세요.

설명

Next 메서드에서 반환된 값이 더 이상 필요하지 않은 경우 VariantClear를 사용하여 pVariant를 지워야 합니다.

예제

다음 코드 예제에서는 다음 메서드를 사용 하 여 속성 목록을 연습 하는 방법을 보여 있습니다.

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