Método IADsGroup::Members (iads.h)
O método IADsGroup::Members recupera uma coleção dos membros imediatos do grupo. A coleção não inclui os membros de outros grupos aninhados dentro do grupo.
A implementação padrão desse método usa LsaLookupSids para consultar informações de nome para os membros do grupo. LsaLookupSids tem uma limitação máxima de 20480 SIDs que pode converter, portanto, essa limitação também se aplica a esse método.
Sintaxe
HRESULT Members(
[out] IADsMembers **ppMembers
);
Parâmetros
[out] ppMembers
Ponteiro para um ponteiro de interface IADsMembers que recebe a coleção de membros do grupo. O chamador deve liberar essa interface quando ela não for mais necessária.
Retornar valor
Esse método dá suporte aos valores retornados padrão, incluindo S_OK. Para obter mais informações e outros valores retornados, consulte Códigos de erro ADSI.
Comentários
O método Membros IADsMembers usará o mesmo provedor.
Exemplos
O exemplo de código a seguir enumera todos os membros de um grupo.
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
O exemplo de código a seguir enumera todos os membros de um grupo.
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;
}
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | iads.h |
| DLL | Activeds.dll |