Поделиться через

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

  • Статья

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

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

Синтаксис

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

Требования

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

См. также раздел

Коды ошибок ADSI

IADsGroup

Методы свойств IADsGroup

IADsMembers