Metodo IADsGroup::Members (iads.h)

Articolo
02/26/2024

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

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	iads.h
DLL	Activeds.dll

Vedi anche

Codici di errore ADSI

IADsGroup

Metodi della proprietà IADsGroup

IADsMembers

Condividi tramite