Metodo IRunningObjectTable::Revoke (objidl.h)
Rimuove una voce dalla tabella di oggetti in esecuzione (ROT) registrata in precedenza da una chiamata a IRunningObjectTable::Register.
Sintassi
HRESULT Revoke(
[in] DWORD dwRegister
);
Parametri
[in] dwRegister
Identificatore della voce ROT da revocare.
Valore restituito
Questo metodo può restituire i valori restituiti standard E_INVALIDARG e S_OK.
Commenti
Questo metodo annulla l'effetto di una chiamata a IRunningObjectTable::Register, rimuovendo sia il moniker che il puntatore all'oggetto identificato da tale moniker.
Note ai chiamanti
Un provider di moniker (estrae i moniker che identificano i relativi oggetti per renderli accessibili ad altri) deve chiamare il metodo Revoke per revocare la registrazione dei relativi oggetti quando si arresta l'esecuzione. Deve avere precedentemente chiamato IRunningObjectTable::Register e archiviato l'identificatore restituito da tale metodo; usa tale identificatore durante la chiamata a Revoke.Il tipo più comune di provider di moniker è un'origine di collegamento a documenti composti. Sono incluse le applicazioni server che supportano il collegamento ai documenti (o parti di un documento) e alle applicazioni contenitore che supportano il collegamento a incorporamenti all'interno dei documenti. Le applicazioni server che non supportano il collegamento possono anche usare rot per collaborare con le applicazioni contenitore che supportano il collegamento a incorporamenti.
Se si sta scrivendo un'applicazione contenitore, è necessario revocare la registrazione di un documento quando il documento viene chiuso. È inoltre necessario revocare la registrazione di un documento prima di registrarla nuovamente quando viene rinominata.
Se si scrive un'applicazione server, è necessario revocare la registrazione di un oggetto quando l'oggetto viene chiuso. È inoltre necessario revocare la registrazione di un oggetto prima di registrarla nuovamente quando il documento contenitore viene rinominato (vedere IOleObject::SetMoniker).
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | objidl.h |