IADsMembers, méthodes de propriété

Les méthodes de l’interface IADsMembers lisent et écrivent les propriétés décrites dans cette rubrique. Pour plus d’informations, consultez Méthodes de propriété d’interface.

Propriétés

Count

Indique le nombre d’éléments dans le conteneur. Si le filtre est défini, count retourne uniquement le nombre d’éléments correspondant à la description du filtre.

Type d'accès : Lecture seule

Type de données de script : LONG

// C++ method syntax
HRESULT get_Count(
  [out] LONG* plCountr
);

Filter

Indique le filtre. La syntaxe des entrées dans le tableau de filtres est la même que celle utilisée sur l’interface IADsContainer .

Type d’accès : Lecture/écriture

Type de données de script : VARIANT

// C++ method syntax
HRESULT get_Filter(
  [out] VARIANT* pvFilter
);
HRESULT put_Filter(
  [in] VARIANT vFilter
);

Notes

Les fournisseurs système ADSI ne prennent pas en charge la méthode de propriété IADsMembers::get_Count .

Exemples

L’exemple de code suivant montre comment utiliser les méthodes de propriété de cette interface.

Dim grp As IADsGroup
On Error GoTo Cleanup

Set grp = GetObject("WinNT://myComputer/someGroup")
grp.members.filter = Array("user")
For Each usr In grp.Members
    MsgBox usr.Name & "," & usr.Class & "," & usr.AdsPath
Next

Cleanup:
    If (Err.Number<>0) Then
        MsgBox("An error has occurred. " & Err.Number)
    End If
    Set grp = Nothing

L’exemple de code suivant utilise la méthode IADsMembers::p ut_Filter pour préparer une énumération de la collection de membres d’un groupe.

IADsGroup *pGroup;
HRESULT hr = S_OK;

LPWSTR grpPath = L"WinNT://myComputer/someGroup";
hr = ADsGetObject(grpPath,IID_IADsGroup,(void**)&pGroup);
if(FAILED(hr)){goto Cleanup;}

IADsMembers *pMembers;
hr = pGroup->Members(&pMembers);
if(FAILED(hr)){goto Cleanup;}

hr = pGroup->Release();

SAFEARRAY *sa = CreateSafeArray(L"user");
hr = pMembers->put_Filter(sa);
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(pGroup) pGroup->Release();
    if(pMembers) pMembers->Release();
    return hr;

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
En-tête	Iads.h
DLL	Activeds.dll
IID	IID_IADsMembers est défini comme 451A0030-72EC-11CF-B03B-00AA006E0975

Voir aussi

IADsContainer

IADsMembers::get__NewEnum

IADsMembers

Méthodes de propriété d’interface