IADsGroup ::Members, méthode (iads.h)
La méthode IADsGroup ::Members récupère une collection des membres immédiats du groupe. La collection n’inclut pas les membres d’autres groupes imbriqués dans le groupe.
L’implémentation par défaut de cette méthode utilise LsaLookupSids pour interroger les informations de nom des membres du groupe. LsaLookupSids a une limite maximale de 20480 SID qu’il peut convertir, par conséquent cette limitation s’applique également à cette méthode.
Syntaxe
HRESULT Members(
[out] IADsMembers **ppMembers
);
Paramètres
[out] ppMembers
Pointeur vers un pointeur d’interface IADsMembers qui reçoit la collection de membres du groupe. L’appelant doit libérer cette interface lorsqu’elle n’est plus nécessaire.
Valeur retournée
Cette méthode prend en charge les valeurs de retour standard, y compris les S_OK. Pour plus d’informations et d’autres valeurs de retour, consultez Codes d’erreur ADSI.
Remarques
La méthode IADsMembersMembers utilise le même fournisseur.
Exemples
L’exemple de code suivant énumère tous les membres d’un groupe.
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
L’exemple de code suivant énumère tous les membres d’un groupe.
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;
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | iads.h |
| DLL | Activeds.dll |