Metodo IADsGroup::Members (iads.h)

Il metodo IADsGroup::Members recupera una raccolta dei membri immediati del gruppo. La raccolta non include i membri di altri gruppi annidati all'interno del gruppo.

L'implementazione predefinita di questo metodo usa LsaLookupSids per eseguire query sulle informazioni sul nome per i membri del gruppo. LsaLookupSids ha una limitazione massima di 20480 SID che può convertire, pertanto tale limitazione si applica anche a questo metodo.

Sintassi

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

Parametri

[out] ppMembers

Puntatore a un puntatore all'interfaccia IADsMembers che riceve la raccolta di membri del gruppo. Il chiamante deve rilasciare questa interfaccia quando non è più necessaria.

Valore restituito

Questo metodo supporta i valori restituiti standard, inclusi i S_OK. Per altre informazioni e altri valori restituiti, vedere Codici di errore ADSI.

Commenti

Il metodo IADsMembersMembers utilizzerà lo stesso provider.

Esempio

Nell'esempio di codice seguente vengono enumerati tutti i membri di un gruppo.

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

Nell'esempio di codice seguente vengono enumerati tutti i membri di un gruppo.

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

Requisiti

Vedi anche

Codici di errore ADSI

IADsGroup

Metodi della proprietà IADsGroup

IADsMembers