ITsSbResourcePluginStore::AcquireTargetLock-Methode (sbtsv.h)

Sperrt ein Ziel.

Syntax

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

Parameter

[in] targetName

Der Name des zu sperrenden Ziels.

[in] dwTimeout

Das Timeout für den Vorgang in Millisekunden.

[out] ppContext

Gibt einen Zeiger auf den Kontext der Sperre zurück. Geben Sie zum Freigeben der Sperre diesen Zeiger auf die ReleaseTargetLock-Methode an.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Nachdem die Sperre abgerufen wurde, wird davon ausgegangen, dass der aufrufende Thread exklusiven Zugriff auf das Zielobjekt hat und daher kein anderer Thread (auf demselben Computer) es aktualisieren kann. Daher muss der aufrufende Thread die ReleaseTargetLock-Methode aufrufen, sobald er die erforderlichen Updates am Zielobjekt vorgenommen hat.

Wichtig: Diese Sperre verhindert nicht vollständig, dass Zielobjekte extern geändert werden, wenn mehr als ein Verbindungsbroker in der Bereitstellung vorhanden ist. Der aufrufende Thread muss vorbereitet sein, um einen Fehler ordnungsgemäß zu behandeln und das Zielupdate erneut auszuführen.
 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2016
Zielplattform Windows
Kopfzeile sbtsv.h

Weitere Informationen

ITsSbResourcePluginStore