Metodo IADsCollection::Remove (iads.h)

Il metodo IADsCollection::Remove rimuove l'elemento denominato da questo insieme ADSI.

Sintassi

HRESULT Remove(
  [in] BSTR bstrItemToBeRemoved
);

Parametri

[in] bstrItemToBeRemoved

Stringa Unicode con terminazione Null che specifica il nome dell'elemento specificato da IADsCollection::Add.

Valore restituito

Questo metodo supporta i valori restituiti standard, inclusi i S_OK. Per altre informazioni e altri valori restituiti, vedere Codici di errore ADSI.

Commenti

Le raccolte per un servizio directory possono essere costituite anche da un set di oggetti non modificabili.

Le raccolte che non supportano la rimozione diretta degli elementi devono restituire E_NOTIMPL.

Esempio

Nell'esempio di codice di Visual Basic seguente viene illustrato come rimuovere un oggetto sessione denominato da una raccolta di sessioni attive del servizio file.

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

Nell'esempio di codice C++ seguente viene illustrato come rimuovere un oggetto sessione denominato da una raccolta di sessioni del servizio file attive.

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;
}

Requisiti

Vedi anche

Codici di errore ADSI

IADsCollection

IADsCollection::Add