IADsGroup：：Members 方法 (iads.h)

發行項
02/29/2024

IADsGroup：：Members 方法會擷取群組立即成員的集合。集合不包含群組內巢狀之其他群組的成員。

此方法的預設實作會使用 LsaLookupSids 來查詢群組成員的名稱資訊。 LsaLookupSids 的最大限制為 20480 SID，因此該限制也適用於此方法。

語法

HRESULT Members(
  [out] IADsMembers **ppMembers
);

參數

[out] ppMembers

接收群組成員集合之 IADsMembers 介面指標的指標。當不再需要此介面時，呼叫端必須釋放此介面。

傳回值

這個方法支持標準傳回值，包括 S_OK。如需詳細資訊和其他傳回值，請參閱 ADSI 錯誤碼。

備註

IADsMembersMembers 方法會使用相同的提供者。

範例

下列程式代碼範例會列舉群組的所有成員。

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

下列程式代碼範例會列舉群組的所有成員。

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;
}