Compartir a través de


Método IADsGroup::Members (iads.h)

El método IADsGroup::Members recupera una colección de los miembros inmediatos del grupo. La colección no incluye los miembros de otros grupos anidados dentro del grupo.

La implementación predeterminada de este método usa LsaLookupSids para consultar la información del nombre de los miembros del grupo. LsaLookupSids tiene una limitación máxima de 20480 SID que puede convertir, por lo que esa limitación también se aplica a este método.

Sintaxis

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

Parámetros

[out] ppMembers

Puntero a un puntero de interfaz IADsMembers que recibe la colección de miembros del grupo. El autor de la llamada debe liberar esta interfaz cuando ya no sea necesario.

Valor devuelto

Este método admite los valores devueltos estándar, incluidos S_OK. Para obtener más información y otros valores devueltos, vea Códigos de error adsi.

Comentarios

El método IADsMembersMembers usará el mismo proveedor.

Ejemplos

En el ejemplo de código siguiente se enumeran todos los miembros de un grupo.

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

En el ejemplo de código siguiente se enumeran todos los miembros de un grupo.

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

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado iads.h
Archivo DLL Activeds.dll

Consulte también

Códigos de error adsi

IADsGroup

Métodos de propiedad IADsGroup

IADsMembers