OleNoteObjectVisible, fonction (ole2.h)

Article
02/29/2024

Incrémente ou décrémente une référence externe qui maintient un objet dans l’état en cours d’exécution.

Syntaxe

HRESULT OleNoteObjectVisible(
  [in] LPUNKNOWN pUnknown,
  [in] BOOL      fVisible
);

Paramètres

[in] pUnknown

Pointeur vers l’interface IUnknown sur l’objet qui doit être verrouillé ou déverrouillé.

[in] fVisible

Indique si l’objet est visible. Si la valeur est TRUE, OLE incrémente le nombre de références pour maintenir l’objet visible et actif, quelles que soient les opérations, inscriptions ou révocations IUnknown ::AddRef et IUnknown ::Release externes ou internes. Si la valeur est FALSE, OLE libère sa conservation (décrémente le nombre de références) et l’objet peut être fermé.

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 OleNoteObjectVisible appelle la fonction CoLockObjectExternal . Il est fourni en tant que fonction distincte pour renforcer la nécessité de verrouiller un objet lorsqu’il devient visible par l’utilisateur et de libérer l’objet lorsqu’il devient invisible. Cela crée un verrou fort au nom de l’utilisateur pour garantir que l’objet ne peut pas être fermé par son conteneur tant qu’il est visible.

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

Partager via