IADsCollection::Remove-Methode (iads.h)

Die IADsCollection::Remove-Methode entfernt das benannte Element aus diesem ADSI-Auflistungsobjekt.

Syntax

HRESULT Remove(
  [in] BSTR bstrItemToBeRemoved
);

Parameter

[in] bstrItemToBeRemoved

Die mit Null beendete Unicode-Zeichenfolge, die den Namen des Elements angibt, wie es von IADsCollection::Add angegeben wurde.

Rückgabewert

Diese Methode unterstützt die Standardrückgabewerte, einschließlich S_OK. Weitere Informationen und andere Rückgabewerte finden Sie unter ADSI-Fehlercodes.

Hinweise

Auflistungen für einen Verzeichnisdienst können auch aus einem Satz unveränderlicher Objekte bestehen.

Sammlungen, die das direkte Entfernen von Elementen nicht unterstützen, müssen E_NOTIMPL zurückgeben.

Beispiele

Das folgende Visual Basic-Codebeispiel zeigt, wie ein benanntes Sitzungsobjekt aus einer Sammlung aktiver Dateidienstsitzungen entfernt wird.

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

Das folgende C++-Codebeispiel zeigt, wie ein benanntes Sitzungsobjekt aus einer Auflistung aktiver Dateidienstsitzungen entfernt wird.

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

Anforderungen

Weitere Informationen

ADSI-Fehlercodes

IADsCollection

IADsCollection::Add