IADsGroup::Members 메서드(iads.h)

IADsGroup::Members 메서드는 그룹의 직행 멤버 컬렉션을 검색합니다. 컬렉션에는 그룹 내에 중첩된 다른 그룹의 멤버가 포함되지 않습니다.

이 메서드의 기본 구현에서는 LsaLookupSids 를 사용하여 그룹 멤버의 이름 정보를 쿼리합니다. LsaLookupSids에는 변환할 수 있는 최대 20480 SID 제한이 있으므로 이 메서드에도 해당 제한이 적용됩니다.

구문

HRESULT Members(
  [out] IADsMembers **ppMembers
);

매개 변수

[out] ppMembers

그룹 멤버의 컬렉션을 수신하는 IADsMembers 인터페이스 포인터에 대한 포인터입니다. 호출자는 더 이상 필요하지 않은 경우 이 인터페이스를 해제해야 합니다.

반환 값

이 메서드는 S_OK 포함한 표준 반환 값을 지원합니다. 자세한 내용 및 기타 반환 값은 ADSI 오류 코드를 참조하세요.

설명

IADsMembersMembers 메서드는 동일한 공급자를 사용합니다.

예제

다음 코드 예제에서는 그룹의 모든 멤버를 열거합니다.

Dim grp As IADsGroup
Dim memberList As IADsMembers
Dim member As IADs

On Error GoTo Cleanup
 
Set grp = GetObject("WinNT://Microsoft/Administrators")
Set memberList = grp.Members
For Each m In memberList
    Set member = m
    Debug.Print member.Name & "(" & member.Class & ")"
Next

Cleanup:
    If (Err.Number<>0) Then
        MsgBox("An error has occurred. " & Err.Number)
    End If
    Set grp = Nothing
    Set member = Nothing
    Set memberList = Nothing

다음 코드 예제에서는 그룹의 모든 멤버를 열거합니다.

HRESULT EnumerateGroupMembers(IADsGroup *pGroup)
{
    IADsMembers *pMembers;
    HRESULT hr = S_OK;
    hr = pGroup->Members(&pMembers);
    if(FAILED(hr)){goto Cleanup;}
 
    hr = EnumMembers(pMembers);  // For more information and a code
                                    example, see IADsMembers::get__NewEnum.
    if(FAILED(hr)){goto Cleanup;}

Cleanup:
    if(pMembers)
        pMembers->Release();

    return hr;
}

요구 사항

추가 정보

ADSI 오류 코드

IADsGroup

IADsGroup 속성 메서드

IADsMembers