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
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | iads.h |
| DLL | Activeds.dll |