Méthode ITsSbResourcePluginStore ::AcquireTargetLock (sbtsv.h)

Article
03/04/2024

Verrouille une cible.

Syntaxe

HRESULT AcquireTargetLock(
  [in]  BSTR     targetName,
  [in]  DWORD    dwTimeout,
  [out] IUnknown **ppContext
);

Paramètres

[in] targetName

Nom de la cible à verrouiller.

[in] dwTimeout

Délai d’attente de l’opération, en millisecondes.

[out] ppContext

Retourne un pointeur vers le contexte du verrou. Pour libérer le verrou, fournissez ce pointeur vers la méthode ReleaseTargetLock .

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Une fois le verrou acquis, le thread appelant est supposé avoir un accès exclusif à l’objet cible et par conséquent, aucun autre thread (au sein de la même machine) ne peut le mettre à jour. Par conséquent, le thread appelant doit appeler la méthode ReleaseTargetLock dès qu’il a effectué les mises à jour nécessaires à l’objet cible.

Important : ce verrou n’empêche pas complètement les objets cibles d’être modifiés en externe si plusieurs répartiteur de connexions existent dans le déploiement. Le thread appelant doit être prêt à gérer une défaillance correctement et à réessayer la mise à jour cible.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2016
Plateforme cible	Windows
En-tête	sbtsv.h

Voir aussi

ITsSbResourcePluginStore

Partager via