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 |