IADsGroup::Tambahkan metode (iads.h)

Metode IADsGroup::Add menambahkan objek ADSI ke grup yang sudah ada.

Sintaks

HRESULT Add(
  [in] BSTR bstrNewItem
);

Parameter

[in] bstrNewItem

Berisi BSTR yang menentukan ADsPath objek untuk ditambahkan ke grup. Untuk informasi selengkapnya, lihat Keterangan.

Mengembalikan nilai

Berikut ini adalah nilai pengembalian yang paling umum. Untuk informasi selengkapnya tentang nilai pengembalian, lihat Kode Kesalahan ADSI.

Keterangan

Jika penyedia LDAP digunakan untuk mengikat objek IADsGroup , bentuk ADsPath yang sama harus ditentukan dalam parameter bstrNewItem . Misalnya, jika ADsPath yang digunakan untuk mengikat objek IADsGroup menyertakan server, ADsPath dalam parameter bstrNewItem harus berisi awalan server yang sama. Demikian juga, jika jalur tanpa server digunakan untuk mengikat objek IADsGroup , parameter bstrNewItem juga harus berisi jalur tanpa server. Saat menggunakan awalan server, penundaan dapat terjadi jika grup dan anggota baru berasal dari domain yang berbeda, karena permintaan dapat dikirim ke pengontrol domain yang salah dan dirujuk ke pengendali domain dari domain yang benar dan dicoba kembali di sana. Pengecualian terjadi saat menambahkan atau menghapus anggota menggunakan GUID atau pengidentifikasi keamanan (SID) ADsPath. Dalam hal ini, jalur tanpa server harus selalu digunakan di bstrNewItem.

Penyedia LDAP untuk Direktori Aktif memungkinkan anggota ditambahkan ke grup menggunakan bentuk string anggota SID. Parameter bstrNewItem dapat berisi string SID dalam formulir berikut.

LDAP://SID=<010500000000000515000000c6bb507afbda8b7f43170a325b040000>

Untuk informasi selengkapnya tentang string SID di Direktori Aktif, lihat Mengikat ke Objek Menggunakan SID.

Penyedia WinNT untuk Direktori Aktif juga memungkinkan anggota ditambahkan ke grup menggunakan bentuk string SID anggota. Parameter bstrNewItem dapat berisi string SID dalam formulir berikut.

WinNT://S-1-5-21-35135249072896"

Contoh

Contoh kode berikut menunjukkan cara menambahkan objek pengguna ("jeff") ke grup ("Administrator") pada domain "Fabrikam", menggunakan penyedia WinNT.

Dim grp As IADsGroup
Set grp = GetObject("WinNT://Fabrikam/Administrators")
grp.Add ("WinNT://Fabrikam/jeff")

Contoh kode berikut menunjukkan cara menambahkan objek pengguna ke grup menggunakan penyedia LDAP.

Dim grp As IADsGroup
On Error GoTo Cleanup

Set grp = GetObject("LDAP://CN=Administrators, CN=Users, DC=Fabrikam, DC=com")
grp.Add("LDAP://CN=Jeff Smith, OU=Sales,DC=Fabrikam,DC=com")

Cleanup:
    If (Err.Number<>0) Then
        MsgBox("An error has occurred. " & Err.Number)
    End If
    Set grp = Nothing

Contoh kode berikut menambahkan akun pengguna yang sudah ada ke grup Administrator.

IADsGroup *pGroup = NULL;
HRESULT hr = S_OK;
LPWSTR adsPath = L"WinNT://Fabrikam/Administrators";
hr = ADsGetObject(adsPath,IID_IADsGroup,(void**)&pGroup);
if(FAILED(hr)) {goto Cleanup;}

// This assumes that the "WinNT://Fabrikam/jeff" user account exists 
// and does not already belong to the Administrators group.

hr = pGroup->Add(_bstr_t("WinNT://Fabrikam/jeff"));
if(FAILED(hr)){goto Cleanup;}

Cleanup:
    if(pGroup)
        pGroup->Release();

    return hr;

Persyaratan

Lihat juga

Kode Kesalahan ADSI

Mengikat ke Objek Menggunakan SID

IADSGroup

Metode Properti IADsGroup

IADsMembers