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

O método IADsCollection::Remove remove o item nomeado deste objeto de coleção ADSI.

Sintaxe

HRESULT Remove(
  [in] BSTR bstrItemToBeRemoved
);

Parâmetros

[in] bstrItemToBeRemoved

A cadeia de caracteres Unicode terminada em nulo que especifica o nome do item conforme especificado por IADsCollection::Add.

Valor retornado

Esse método dá suporte aos valores retornados padrão, incluindo S_OK. Para obter mais informações e outros valores retornados, consulte Códigos de erro ADSI.

Comentários

Coleções de um serviço de diretório também podem consistir em um conjunto de objetos imutáveis.

Coleções que não dão suporte à remoção direta de itens são necessárias para retornar E_NOTIMPL.

Exemplos

O exemplo de código do Visual Basic a seguir mostra como remover um objeto de sessão nomeado de uma coleção de sessões de serviço de arquivo ativas.

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

O exemplo de código C++ a seguir mostra como remover um objeto de sessão nomeado de uma coleção de sessões de serviço de arquivo ativas.

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 com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	iads.h
DLL	Activeds.dll

Confira também

Códigos de erro ADSI

IADsCollection

IADsCollection::Add