Méthode ITsSbResourcePluginStoreEx::AcquireTargetLock

Article
06/13/2023

Verrouille une cible.

Syntaxe

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

Paramètres

targetName [in]: Nom de la cible à verrouiller.
dwTimeout [in]: Délai d’expiration de l’opération, en millisecondes.
ppContext [out]: 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 .

Notes

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 du même ordinateur) 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 s’il existe plusieurs services Broker de connexion dans le déploiement. Le thread appelant doit être prêt à gérer correctement une défaillance et à réessayer la mise à jour cible.

Cette méthode est disponible sur Windows Server 2012 R2 avec KB3091411 installé dans l’interface ITsSbResourcePluginStoreEx.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2012 R2
Fin de la prise en charge des serveurs	Windows Server 2012 R2
IDL	SbTsV.idl
IID	IID_ITsSbResourcePluginStoreEx est défini comme 80b83ffd-625d-11e5-bea1-a0481c7e9064

Voir aussi

ITsSbResourcePluginStoreEx

Partager via