Метод 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

См. также раздел

Коды ошибок ADSI

IADsCollection

IADsCollection::Add