Partager via


Méthode IRunningObjectTable ::NoteChangeTime (objidl.h)

Enregistre l’heure de la dernière modification d’un objet en cours d’exécution. L’objet doit avoir déjà été inscrit auprès de la table d’objets en cours d’exécution (ROT). Cette méthode stocke l’heure de la dernière modification dans rot.

Syntaxe

HRESULT NoteChangeTime(
  [in] DWORD    dwRegister,
  [in] FILETIME *pfiletime
);

Paramètres

[in] dwRegister

Identificateur de l’entrée ROT de l’objet modifié. Cette valeur a été précédemment retournée par IRunningObjectTable ::Register.

[in] pfiletime

Pointeur vers une structure FILETIME contenant l’heure de la dernière modification de l’objet.

Valeur retournée

Cette méthode peut retourner les valeurs de retour standard E_INVALIDARG et S_OK.

Remarques

Le temps enregistré par cette méthode peut être récupéré en appelant IRunningObjectTable ::GetTimeOfLastChange.

Notes aux appelants

Un fournisseur de moniker (remet des monikers identifiant ses objets pour les rendre accessibles aux autres) doit appeler la méthode NoteChangeTime chaque fois que ses objets sont modifiés. 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 NoteChangeTime.

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.

Lorsqu’un objet est inscrit pour la première fois dans le ROT, le ROT enregistre son heure de dernière modification comme valeur retournée en appelant IMoniker ::GetTimeOfLastChange sur le moniker en cours d’inscription.

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

Voir aussi

IMoniker ::GetTimeOfLastChange

IRunningObjectTable