Partager via


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