Методы свойств IADsGroup

Методы свойств интерфейса IADsGroup считывают и записывают следующие свойства. Дополнительные сведения см. в разделе Методы свойств интерфейса.

Свойства

Описание

Указывает текстовое описание членства в группе.

Тип доступа: чтение и запись

Тип данных скрипта: BSTR

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

Комментарии

Использование IADsGroup для получения описаний встроенных групп

В следующих примерах показано, как получить сведения об объектах группы Windows по имени. В многоязычной среде встроенные группы иногда известны по разным локализованным именам, что означает, что их нельзя получить напрямую с помощью строковых идентификаторов, таких как "WinNT://Microsoft/Administrators". В этом случае пользователь может выполнить привязку к известному объекту SID для группы, получить локализованное имя группы и передать его методу GetObject. Дополнительные сведения см. в разделе Известные идентификаторы безопасности.

Примеры

В следующем примере 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++ показано, как выполнить привязку к объекту group и отобразить описание группы.

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

См. также раздел

IAD

IADsGroup

Методы свойств интерфейса