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으로 정의됩니다.

추가 정보

IAD

IADsGroup

Interface 속성 메서드