IADsMembers-Eigenschaftsmethoden

Die Methoden der IADsMembers-Schnittstelle lesen und schreiben die in diesem Thema beschriebenen Eigenschaften. Weitere Informationen finden Sie unter Schnittstelleneigenschaftenmethoden.

Eigenschaften

Anzahl

Gibt die Anzahl der Elemente im Container an. Wenn der Filter festgelegt ist, gibt count nur die Anzahl der Elemente zurück, die der Filterbeschreibung entsprechen.

Zugriffstyp: Schreibgeschützt

Skriptdatentyp: LONG

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

Filter

Gibt den Filter an. Die Syntax der Einträge im Filterarray entspricht der für die IADsContainer-Schnittstelle verwendeten Filter.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: VARIANT

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

Bemerkungen

Die ADSI-Systemanbieter unterstützen die IADsMembers::get_Count-Eigenschaftsmethode nicht.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der Eigenschaftenmethoden dieser Schnittstelle veranschaulicht.

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

Im folgenden Codebeispiel wird die IADsMembers::p ut_Filter-Methode verwendet, um eine Enumeration der Auflistung von Mitgliedern einer Gruppe vorzubereiten.

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;

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	WindowsServer 2008
Header	Iads.h
DLL	Activeds.dll
IID	IID_IADsMembers ist definiert als 451A0030-72EC-11CF-B03B-00AA006E0975

Siehe auch

IADsContainer

IADsMembers::get__NewEnum

IADsMembers

Methoden der Interface-Eigenschaft