Método IADsCollection::Remove (iads.h)

El método IADsCollection::Remove quita el elemento con nombre de este objeto de colección ADSI.

Sintaxis

HRESULT Remove(
  [in] BSTR bstrItemToBeRemoved
);

Parámetros

[in] bstrItemToBeRemoved

Cadena Unicode terminada en null que especifica el nombre del elemento tal como lo especificó IADsCollection::Add.

Valor devuelto

Este método admite los valores devueltos estándar, incluidos S_OK. Para obtener más información y otros valores devueltos, vea Códigos de error adsi.

Comentarios

Las colecciones de un servicio de directorio también pueden constar de un conjunto de objetos inmutables.

Las colecciones que no admiten la eliminación directa de elementos son necesarias para devolver E_NOTIMPL.

Ejemplos

En el siguiente ejemplo de código de Visual Basic se muestra cómo quitar un objeto de sesión con nombre de una colección de sesiones de servicio de archivos activas.

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

En el ejemplo de código de C++ siguiente se muestra cómo quitar un objeto de sesión con nombre de una colección de sesiones de servicio de archivos activas.

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

Requisitos

Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	iads.h
Archivo DLL	Activeds.dll

Consulte también

Códigos de error adsi

IADsCollection

IADsCollection::Add