IADsGroup::Metode anggota (iads.h)

Artikel
02/29/2024

Metode IADsGroup::Members mengambil kumpulan anggota langsung grup. Koleksi tidak menyertakan anggota grup lain yang ditumpuk dalam grup.

Implementasi default metode ini menggunakan LsaLookupSids untuk mengkueri informasi nama untuk anggota grup. LsaLookupSids memiliki batasan maksimum SID 20480 yang dapat dikonversi, oleh karena itu batasan tersebut juga berlaku untuk metode ini.

Sintaks

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

Parameter

[out] ppMembers

Arahkan ke penunjuk antarmuka IADsMembers yang menerima kumpulan anggota grup. Pemanggil harus merilis antarmuka ini ketika tidak lagi diperlukan.

Nilai kembali

Metode ini mendukung nilai pengembalian standar, termasuk S_OK. Untuk informasi selengkapnya dan nilai pengembalian lainnya, lihat Kode Kesalahan ADSI.

Keterangan

Metode Anggota IADsMembers akan menggunakan penyedia yang sama.

Contoh

Contoh kode berikut menghitung semua anggota grup.

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

Contoh kode berikut menghitung semua anggota grup.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	iads.h
DLL	Activeds.dll