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 |