IADsGroup::Hapus metode (iads.h)
Metode IADsGroup::Remove menghapus objek pengguna yang ditentukan dari grup ini. Operasi tidak menghapus objek grup itu sendiri bahkan ketika tidak ada anggota yang tersisa dalam grup.
Sintaks
HRESULT Remove(
[in] BSTR bstrItemToBeRemoved
);
Parameter
[in] bstrItemToBeRemoved
Berisi BSTR yang menentukan ADsPath objek yang akan dihapus dari grup. Untuk informasi selengkapnya tentang parameter ini, lihat bagian 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 bstrItemToBeRemoved . Misalnya, jika ADsPath yang digunakan untuk mengikat ke objek IADsGroup menyertakan server, ADsPath dalam parameter bstrItemToBeRemoved harus berisi awalan server yang sama. Demikian juga, jika jalur tanpa server digunakan untuk mengikat objek IADsGroup , parameter bstrItemToBeRemoved juga harus berisi jalur tanpa server. Pengecualiannya adalah saat menambahkan atau menghapus anggota menggunakan GUID atau SID ADsPath. Dalam hal ini, jalur tanpa server harus selalu digunakan di bstrItemToBeRemoved.
Anda dapat menggunakan SID di ADsPath untuk menghapus prinsip keamanan dari grup melalui penyedia WinNT. Misalnya, misalkan SID pengguna, "Fabrikam\jeffsmith", adalah S-1-5-21-35135249072896, pernyataan berikut:
Dim group As IADsGroup
group.Remove("WinNT://S-1-5-21-35135249072896")
setara dengan
Dim group As IADsGroup
group.Remove("WinNT://Fabrikam/jeffsmith")
Menghapus anggota menggunakan SID melalui penyedia WinNT adalah fitur baru di Windows 2000 dan paket DSCLIENT.
Contoh
Contoh kode berikut menghapus akun pengguna dari grup.
Dim grp As IADsGroup
On Error GoTo Cleanup
Set grp = GetObject("WinNT://Fabrikam/Administrators")
grp.Remove ("WinNT://Fabrikam/jeffsmith")
Cleanup:
If (Err.Number<>0) Then
MsgBox("An error has occurred. " & Err.Number)
End If
Set grp = Nothing
Contoh kode berikut menghapus pengguna dari grup.
IADsGroup *pGroup = NULL;
HRESULT hr = S_OK;
LPWSTR usrPath = L"WinNT://Fabrikam/jeffsmith";
LPWSTR grpPath = L"WinNT://Fabrikam/Administrators";
hr = ADsGetObject(grpPath, IID_IADsGroup, (void**)&pGroup);
if(FAILED(hr)){goto Cleanup;}
hr = pGroup->Remove(CComBSTR(usrPath));
if(FAILED(hr)){goto Cleanup;}
Cleanup:
if(pGroup)
pGroup->Release();
Persyaratan
| Klien minimum yang didukung | Windows Vista |
| Server minimum yang didukung | Windows Server 2008 |
| Target Platform | Windows |
| Header | iads.h |
| DLL | Activeds.dll |