Méthode IRunningObjectTable ::Revoke (objidl.h)
Supprime une entrée de la table d’objets en cours d’exécution (ROT) précédemment inscrite par un appel à IRunningObjectTable ::Register.
Syntaxe
HRESULT Revoke(
[in] DWORD dwRegister
);
Paramètres
[in] dwRegister
Identificateur de l’entrée ROT à révoquer.
Valeur retournée
Cette méthode peut retourner les valeurs de retour standard E_INVALIDARG et S_OK.
Remarques
Cette méthode annule l’effet d’un appel à IRunningObjectTable ::Register, en supprimant à la fois le moniker et le pointeur vers l’objet identifié par ce moniker.
Notes aux appelants
Un fournisseur de moniker (remet des monikers identifiant ses objets pour les rendre accessibles aux autres) doit appeler la méthode Revoke pour révoquer l’inscription de ses objets lorsqu’elle cesse de s’exécuter. Il doit avoir précédemment appelé IRunningObjectTable ::Register et stocké l’identificateur retourné par cette méthode ; il utilise cet identificateur lors de l’appel de Revoke.Le type le plus courant de fournisseur de moniker est une source de lien de document composé. Cela inclut les applications serveur qui prennent en charge la liaison à leurs documents (ou parties d’un document) et les applications conteneur qui prennent en charge la liaison à des incorporations dans leurs documents. Les applications serveur qui ne prennent pas en charge la liaison peuvent également utiliser le ROT pour coopérer avec les applications conteneur qui prennent en charge la liaison à des incorporations.
Si vous écrivez une application conteneur, vous devez révoquer l’inscription d’un document lorsque celui-ci est fermé. Vous devez également révoquer l’inscription d’un document avant de le réinscrire lorsqu’il est renommé.
Si vous écrivez une application serveur, vous devez révoquer l’inscription d’un objet lorsque l’objet est fermé. Vous devez également révoquer l’inscription d’un objet avant de le réinscrire lorsque son document conteneur est renommé (voir IOleObject ::SetMoniker).
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | objidl.h |