IADsCollection::Hapus metode (iads.h)

Metode IADsCollection::Remove menghapus item bernama dari objek koleksi ADSI ini.

Sintaks

HRESULT Remove(
  [in] BSTR bstrItemToBeRemoved
);

Parameter

[in] bstrItemToBeRemoved

String Unicode yang dihentikan null yang menentukan nama item seperti yang ditentukan oleh IADsCollection::Add.

Mengembalikan nilai

Metode ini mendukung nilai pengembalian standar, termasuk S_OK. Untuk informasi selengkapnya dan nilai pengembalian lainnya, lihat Kode Kesalahan ADSI.

Keterangan

Koleksi untuk layanan direktori juga dapat terdiri dari sekumpulan objek yang tidak dapat diubah.

Koleksi yang tidak mendukung penghapusan langsung item diperlukan untuk mengembalikan E_NOTIMPL.

Contoh

Contoh kode Visual Basic berikut ini memperlihatkan cara menghapus objek sesi bernama dari kumpulan sesi layanan file aktif.

Dim fso As IADsFileServiceOperations 
Dim ses As IADsSession
Dim coll As IADsCollection
Dim mySessionName As String

On Error GoTo Cleanup

Set fso = GetObject("WinNT://myComputer/FabrikamServer") 
Set coll = fso.Sessions

' Insert code to set mySessionName to the name of the mySession 
' session object.
 
' The following statement invokes IADsCollection::Remove.
coll.Remove mySessionName

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

Contoh kode C++ berikut menunjukkan cara menghapus objek sesi bernama dari kumpulan sesi layanan file aktif.

HRESULT RemoveASessionObjectFromCollection()
{
    LPWSTR adspath = L"WinNT://myComputer/FabrikamServer";
    HRESULT hr = S_OK;
    IADsCollection *pColl = NULL;
    IADsFileServiceOperations *pFso = NULL;

    hr = ADsGetObject(adspath,IID_IADsFileServiceOperations,(void**)&pFso);
    if(FAILED(hr)) {goto Cleanup;}

    hr = pFso->Sessions(&pColl);
    if(FAILED(hr)) {goto Cleanup;}

    hr = pColl->Remove(CComBSTR("MySession"));

Cleanup
    if(pFso) pFso->Release();
    if(pColl) pColl->Release();

    return hr;
}

Persyaratan

Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	iads.h
DLL	Activeds.dll

Lihat juga

Kode Kesalahan ADSI

IADsCollection

IADsCollection::Add