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

Vedi anche

IRunningObjectTable