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 方法。 如需詳細資訊，請參閱 已知的 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 屬性方法