IADsGroup 属性方法

IADsGroup 接口的属性方法读取和写入以下属性。 有关详细信息，请参阅 Interface 属性方法。

属性

描述

指示组成员身份的文本说明。

访问类型：读/写

脚本数据类型： BSTR

// C++ method syntax
HRESULT get_Description(
  [out] BSTR* pbstrDescription
);
HRESULT put_Description(
  [in] BSTR bstrDescription
);

注解

使用 IADsGroup 检索内置组的说明

以下示例演示如何按名称检索有关 Windows 组对象的信息。 在多语言环境中，内置组有时由不同的本地化名称已知，这意味着无法使用字符串标识符（如“WinNT://Microsoft/管理员istrators”）直接检索它们。 在这种情况下，用户可以绑定到组的已知 SID 对象，检索本地化的组名称，并将其提供给 GetObject 方法。 有关详细信息，请参阅 已知的 SID。

示例

以下 Visual Basic 示例演示如何绑定到组对象并显示组的说明。

Dim grp As IADsGroup
On Error GoTo Cleanup

Set grp = GetObject("WinNT://Microsoft/Administrators")
Debug.Print grp.Description

Cleanup
    If (Err.Number<>0) Then
        MsgBox("An error has occurred. " & Err.Number)
    End If
    Set grp = Nothing

以下 C++ 示例演示如何绑定到组对象并显示组的说明。

IADsGroup *pGroup = NULL;
HRESULT hr = S_OK;
LPWSTR adsPath = L"WinNT://localHost/Administrators";
BSTR bstr;

hr = ADsGetObject(adsPath,IID_IADsGroup,(void**)&pGroup);

if(FAILED(hr)) {goto Cleanup;}

hr = pGroup->get_Description(&bstr);
if(FAILED(hr)) {goto Cleanup;}

printf("Description: %S\n",bstr);

Cleanup:
    SysFreeString(bstr);
    if(pGroup) 
        pGroup->Release();

    return hr;

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
标头	Iads.h
DLL	Activeds.dll
IID	IID_IADsGroup定义为 27636B00-410F-11CF-B1FF-02608C9E7553

另请参阅

IADs

IADsGroup

Interface 属性方法