IADsMembers 屬性方法

IADsMembers介面的方法會讀取和寫入本主題中所述的屬性。 如需詳細資訊，請參閱 介面屬性方法。

屬性

Count

指出容器中的專案數目。 如果設定篩選準則，則 count 只會傳回符合篩選描述的專案數目。

存取類型：唯讀

腳本資料類型： LONG

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

Filter

指出篩選準則。 篩選陣列中專案的語法與 IADsContainer 介面上使用的 Filter 相同。

存取類型：讀取/寫入

腳本資料類型： VARIANT

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

備註

ADSI 系統提供者不支援 IADsMembers：：get_Count 屬性方法。

範例

下列程式碼範例示範如何使用這個介面的 屬性方法。

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

下列程式碼範例會使用 IADsMembers：:p ut_Filter 方法來準備群組成員集合的列舉。

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;

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
標頭	Iads.h
DLL	Activeds.dll
IID	IID_IADsMembers定義為 451A0030-72EC-11CF-B03B-00AA006E0975

另請參閱

IADsContainer

IADsMembers：：get__NewEnum

IADsMembers

Interface 屬性方法