Метод IADsCollection::Remove (iads.h)
Метод IADsCollection::Remove удаляет именованный элемент из этого объекта коллекции ADSI.
Синтаксис
HRESULT Remove(
[in] BSTR bstrItemToBeRemoved
);
Параметры
[in] bstrItemToBeRemoved
Строка Юникода, завершающаяся нулевым значением, которая указывает имя элемента в том виде, в котором оно было указано в IADsCollection::Add.
Возвращаемое значение
Этот метод поддерживает стандартные возвращаемые значения, включая S_OK. Дополнительные сведения и другие возвращаемые значения см. в разделе Коды ошибок ADSI.
Комментарии
Коллекции для службы каталогов также могут состоять из набора неизменяемых объектов.
Коллекции, которые не поддерживают прямое удаление элементов, должны возвращать E_NOTIMPL.
Примеры
В следующем примере кода Visual Basic показано, как удалить именованный объект сеанса из коллекции активных сеансов файловой службы.
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
В следующем примере кода C++ показано, как удалить объект именованного сеанса из коллекции активных сеансов файловой службы.
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;
}
Требования
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | iads.h |
| DLL | Activeds.dll |