Метод IADsGroup::Members (iads.h)

Статья
02/26/2024

Метод IADsGroup::Members извлекает коллекцию непосредственных членов группы. Коллекция не включает членов других групп, вложенных в группу.

Реализация этого метода по умолчанию использует LsaLookupSids для запроса сведений об имени участников группы. LsaLookupSids имеет максимальное ограничение в 20480 идентификаторов безопасности, которые он может преобразовать, поэтому это ограничение также применяется к этому методу.

Синтаксис

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

Параметры

[out] ppMembers

Указатель на указатель интерфейса IADsMembers , который получает коллекцию членов группы. Вызывающий объект должен освободить этот интерфейс, если он больше не требуется.

Возвращаемое значение

Этот метод поддерживает стандартные возвращаемые значения, включая S_OK. Дополнительные сведения и другие возвращаемые значения см. в разделе Коды ошибок ADSI.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	iads.h
DLL	Activeds.dll