IADsCollection::Remove, méthode (iads.h)

  • Article

La méthode IADsCollection::Remove supprime l’élément nommé de cet objet de collection ADSI.

Syntaxe

HRESULT Remove(
  [in] BSTR bstrItemToBeRemoved
);

Paramètres

[in] bstrItemToBeRemoved

Chaîne Unicode terminée par null qui spécifie le nom de l’élément tel qu’il a été spécifié par IADsCollection::Add.

Valeur retournée

Cette méthode prend en charge les valeurs de retour standard, y compris les S_OK. Pour plus d’informations et d’autres valeurs de retour, consultez Codes d’erreur ADSI.

Notes

Les collections d’un service d’annuaire peuvent également se composer d’un ensemble d’objets immuables.

Les collections qui ne prennent pas en charge la suppression directe d’éléments sont requises pour retourner E_NOTIMPL.

Exemples

L’exemple de code Visual Basic suivant montre comment supprimer un objet de session nommé d’une collection de sessions de service de fichiers actives.

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

L’exemple de code C++ suivant montre comment supprimer un objet de session nommé d’une collection de sessions de service de fichiers actives.

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

Configuration requise

   
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête iads.h
DLL Activeds.dll

Voir aussi

Codes d’erreur ADSI

IADsCollection

IADsCollection::Add