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

  • Article

Récupère l’heure de la dernière modification d’un objet.

Syntaxe

HRESULT GetTimeOfLastChange(
  [in]  IMoniker *pmkObjectName,
  [out] FILETIME *pfiletime
);

Paramètres

[in] pmkObjectName

Pointeur vers l’interface IMoniker sur le moniker.

[out] pfiletime

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

Valeur retournée

Cette méthode peut retourner les valeurs suivantes.

Code de retour Description
S_OK
 La commande s'est correctement terminée.
S_FALSE
 Il n’existe aucune entrée pour pmkObjectName dans le ROT, ou que l’objet qu’il identifie n’est plus en cours d’exécution (auquel cas, l’entrée est révoquée).

Remarques

Cette méthode retourne l’heure de modification qui a été signalée pour la dernière fois pour cet objet par un appel à IRunningObjectTable ::NoteChangeTime. Si NoteChangeTime n’a pas été appelé précédemment, la méthode retourne l’heure qui a été enregistrée lorsque l’objet a été inscrit.

Cette méthode est fournie pour permettre de vérifier si une connexion entre deux objets (représenté par un objet contenant un moniker qui identifie l’autre) est à jour. Par exemple, si un objet contient des informations mises en cache sur l’autre objet, cette méthode peut être utilisée pour case activée si l’objet a été modifié depuis la dernière mise à jour du cache. Consultez IMoniker ::GetTimeOfLastChange.

Notes aux appelants

En règle générale, vous appelez GetTimeOfLastChange uniquement si vous écrivez votre propre classe moniker (autrement dit, implémentant l’interface IMoniker ). Vous appelez généralement cette méthode à partir de votre implémentation d’IMoniker ::GetTimeOfLastChange. Toutefois, vous devez le faire uniquement si le paramètre pmkToLeft de IMoniker ::GetTimeOfLastChange a lavaleur NULL. Sinon, vous devez appeler IMoniker ::GetTimeOfLastChange sur votre paramètre pmkToLeft à la place.

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