Metode Properti IADsGroup

Metode properti antarmuka IADsGroup membaca dan menulis properti berikut. Untuk informasi selengkapnya, lihat Metode Properti Antarmuka.

Properti

Deskripsi

Menunjukkan deskripsi tekstual keanggotaan grup.

Jenis akses: Baca/tulis

Jenis data pembuatan skrip: BSTR

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

Keterangan

Menggunakan IADsGroup untuk Mengambil Deskripsi Grup Bawaan

Contoh berikut menunjukkan cara mengambil informasi tentang objek grup Windows berdasarkan nama. Dalam lingkungan multibahasa, grup bawaan terkadang dikenal dengan nama lokal yang berbeda, yang berarti bahwa mereka tidak dapat diambil langsung dengan menggunakan pengidentifikasi string seperti "WinNT://Microsoft/Administrators". Dalam hal ini, pengguna dapat mengikat objek SID terkenal untuk grup, mengambil nama grup yang dilokalkan, dan menyediakannya ke metode GetObject. Untuk informasi selengkapnya, lihat SID terkenal.

Contoh

Contoh Visual Basic berikut menunjukkan cara mengikat objek grup dan menampilkan deskripsi grup.

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

Contoh C++ berikut menunjukkan cara mengikat objek grup dan menampilkan deskripsi grup.

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;

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Header	Iads.h
DLL	Activeds.dll
IID	IID_IADsGroup didefinisikan sebagai 27636B00-410F-11CF-B1FF-02608C9E7553

Lihat juga

IAD

IADsGroup

Metode Properti Antarmuka