Metodo ITsSbResourcePluginStore::AcquireTargetLock (sbtsv.h)

Articolo
03/01/2024

Blocca una destinazione.

Sintassi

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

Parametri

[in] targetName

Nome della destinazione da bloccare.

[in] dwTimeout

Timeout dell'operazione, espresso in millisecondi.

[out] ppContext

Restituisce un puntatore al contesto del blocco. Per rilasciare il blocco, specificare questo puntatore al metodo ReleaseTargetLock .

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Dopo l'acquisizione del blocco, si presuppone che il thread chiamante abbia accesso esclusivo all'oggetto di destinazione e pertanto nessun altro thread (all'interno dello stesso computer) possa aggiornarlo. Pertanto, il thread chiamante deve chiamare il metodo ReleaseTargetLock non appena ha apportato gli aggiornamenti necessari all'oggetto di destinazione.

Importante questo blocco non impedisce completamente che gli oggetti di destinazione vengano modificati esternamente se nella distribuzione esistono più broker di connessione. Il thread chiamante deve essere preparato per gestire correttamente un errore e ripetere l'aggiornamento di destinazione.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2016
Piattaforma di destinazione	Windows
Intestazione	sbtsv.h

Vedi anche

ITsSbResourcePluginStore

Condividi tramite