IADsGroup 属性方法

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

属性

说明

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

访问类型:读/写

脚本数据类型: BSTR

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

注解

使用 IADsGroup 检索内置组的说明

以下示例演示如何按名称检索有关Windows组对象的信息。 在多语言环境中,内置组有时通过不同的本地化名称知道,这意味着无法使用字符串标识符(如“WinNT://Microsoft/Administrators”)直接检索它们。 在这种情况下,用户可以绑定到组的已知 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 属性方法