IADsCollection::Remove method (iads.h)

The IADsCollection::Remove method removes the named item from this ADSI collection object.


  [in] BSTR bstrItemToBeRemoved


[in] bstrItemToBeRemoved

The null-terminated Unicode string that specifies the name of the item as it was specified by IADsCollection::Add.

Return value

This method supports the standard return values, including S_OK. For more information and other return values, see ADSI Error Codes.


Collections for a directory service can also consist of a set of immutable objects.

Collections that do not support direct removal of items are required to return E_NOTIMPL.


The following Visual Basic code example shows how to remove a named session object from a collection of active file service sessions.

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

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

The following C++ code example shows how to remove a named session object from a collection of active file service sessions.

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"));

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

    return hr;


Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header iads.h
DLL Activeds.dll

See also

ADSI Error Codes