OleLockRunning, fonction (ole2.h)

Verrouille un objet en cours d’exécution dans son état d’exécution ou le déverrouille de son état d’exécution.

Syntaxe

HRESULT OleLockRunning(
  [in] LPUNKNOWN pUnknown,
  [in] BOOL      fLock,
  [in] BOOL      fLastUnlockCloses
);

Paramètres

[in] pUnknown

Pointeur vers l’interface IUnknown sur l’objet, que la fonction utilise pour interroger un pointeur vers IRunnableObject.

[in] fLock

TRUE verrouille l’objet dans son état d’exécution. FALSE déverrouille l’objet de son état d’exécution.

[in] fLastUnlockCloses

TRUE spécifie que si la connexion libérée est le dernier verrou externe de l’objet, l’objet doit se fermer. FALSE spécifie que l’objet doit rester ouvert jusqu’à ce qu’il soit fermé par l’utilisateur ou un autre processus.

Valeur retournée

Cette fonction retourne S_OK en cas de réussite. Les autres valeurs possibles sont les suivantes.

Code de retour	Description
E_OUTOFMEMORY	Mémoire insuffisante pour l’opération.
E_INVALIDARG	Un ou plusieurs paramètres ne sont pas valides.
E_UNEXPECTED	Une erreur inattendue s’est produite.

Remarques

La fonction OleLockRunning vous évite d’appeler la méthode IRunnableObject ::LockRunning . Vous pouvez utiliser OleLockRunning et IRunnableObject ::LockRunning de manière interchangeable. Avec le pointeur IUnknown transmis avec le paramètre pUnknown , OleLockRunning interroge un pointeur IRunnableObject . En cas de réussite, il appelle IRunnableObject ::LockRunning et retourne les résultats de l’appel.

Pour plus d’informations sur l’utilisation de cette fonction, consultez IRunnableObject ::LockRunning.

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	ole2.h
Bibliothèque	Ole32.lib
DLL	Ole32.dll

Voir aussi

CoLockObjectExternal

IRunnableObject ::LockRunning

OleNoteObjectVisible