Métodos de propriedade IADsMembers

Os métodos da interface IADsMembers leem e gravam as propriedades descritas neste tópico. Para obter mais informações, consulte Métodos de propriedade de interface.

Propriedades

Count

Indica o número de itens no contêiner. Se o filtro estiver definido, a contagem retornará apenas o número de itens que se ajustam à descrição do filtro.

Tipo de acesso: Somente leitura

Tipo de dados de script: LONG

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

Filter

Indica o filtro. A sintaxe das entradas na matriz de filtro é a mesma que o Filtro usado na interface IADsContainer .

Tipo de acesso: leitura/gravação

Tipo de dados de script: VARIANT

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

Comentários

Os provedores de sistema ADSI não dão suporte ao método de propriedade IADsMembers::get_Count .

Exemplos

O exemplo de código a seguir mostra como usar os métodos de propriedade dessa 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

O exemplo de código a seguir usa o método IADsMembers::p ut_Filter para se preparar para uma enumeração da coleção de membros de um grupo.

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;

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Cabeçalho	Iads.h
DLL	Activeds.dll
IID	IID_IADsMembers é definido como 451A0030-72EC-11CF-B03B-00AA006E0975

Confira também

IADsContainer

IADsMembers::get__NewEnum

IADsMembers

Métodos de propriedade interface