IADsGroup::Members-Methode (iads.h)

Artikel
02/26/2024

Die IADsGroup::Members-Methode ruft eine Auflistung der unmittelbaren Mitglieder der Gruppe ab. Die Auflistung enthält nicht die Mitglieder anderer Gruppen, die innerhalb der Gruppe geschachtelt sind.

Die Standardimplementierung dieser Methode verwendet LsaLookupSids , um Namensinformationen für die Gruppenmitglieder abzufragen. LsaLookupSids hat eine maximale Beschränkung von 20480 SIDs, die konvertiert werden kann, daher gilt diese Einschränkung auch für diese Methode.

Syntax

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

Parameter

[out] ppMembers

Zeiger auf einen IADsMembers-Schnittstellenzeiger , der die Auflistung der Gruppenmitglieder empfängt. Der Aufrufer muss diese Schnittstelle freigeben, wenn sie nicht mehr benötigt wird.

Rückgabewert

Diese Methode unterstützt die Standardrückgabewerte, einschließlich S_OK. Weitere Informationen und andere Rückgabewerte finden Sie unter ADSI-Fehlercodes.

Hinweise

Die IADsMembersMembers-Methode verwendet denselben Anbieter.

Beispiele

Im folgenden Codebeispiel werden alle Mitglieder einer Gruppe aufgelistet.

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

Im folgenden Codebeispiel werden alle Mitglieder einer Gruppe aufgelistet.

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;
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	iads.h
DLL	Activeds.dll