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

Article
02/29/2024

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

Partager via