IADsCollection::Remove, méthode (iads.h)
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 |