Share via

Méthode IClassFactory ::LockServer (unknwn.h)

  • Article

Verrouille une application d’objet ouverte en mémoire. Cela permet de créer des instances plus rapidement.

Syntaxe

HRESULT LockServer(
  [in] BOOL fLock
);

Paramètres

[in] fLock

Si la valeur EST TRUE, incrémente le nombre de verrous ; si la valeur est FALSE, décrémente le nombre de verrous.

Valeur retournée

Cette méthode peut retourner les valeurs de retour standard E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL et S_OK.

Remarques

IClassFactory ::LockServer contrôle si le serveur d’un objet est conservé en mémoire. Le fait de conserver l’application en mémoire permet de créer des instances plus rapidement.

Notes aux appelants

La plupart des clients n’ont pas besoin d’appeler cette méthode. Il est fourni uniquement pour les clients qui nécessitent des performances spéciales lors de la création de plusieurs instances de leurs objets.

Notes aux implémenteurs

Si le nombre de verrous est égal à zéro, qu’il n’y a plus d’objets en cours d’utilisation et que l’application n’est pas sous le contrôle de l’utilisateur, le serveur peut être fermé. Une façon d’implémenter LockServer consiste à appeler la fonction CoLockObjectExternal .

Le processus qui verrouille l’application d’objet est responsable de son déverrouillage. Une fois l’objet de classe libéré, aucun mécanisme ne garantit la connexion de l’appelant à la même classe ultérieurement (comme dans le cas où un objet de classe est inscrit en tant qu’objet à usage unique). Il est important de compter tous les appels, pas seulement le dernier, vers LockServer, car les appels doivent être équilibrés avant de tenter de libérer le pointeur vers l’interface IClassFactory sur l’objet de classe ou une erreur se produit. Pour chaque appel à LockServer avec fLock défini sur TRUE, il doit y avoir un appel à LockServer avec fLock défini sur FALSE. Lorsque le nombre de verrous et le nombre de références d’objets de classe sont tous deux nuls, l’objet de classe peut être libéré.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête unknwn.h (include Unknwn.h)

Voir aussi

CoLockObjectExternal

IClassFactory