ITsSbResourcePluginStoreEx::AcquireTargetLock-Methode

Sperrt ein Ziel.

Syntax

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

Parameter

targetName [in]

Der Name des zu sperrenden Ziels.

dwTimeout [in]

Das Timeout für den Vorgang in Millisekunden.

ppContext [out]

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, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

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.

Diese Methode ist auf Windows Server 2012 R2 verfügbar, wobei KB3091411 in der ITsSbResourcePluginStoreEx-Schnittstelle installiert ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Nicht unterstützt
Unterstützte Mindestversion (Server)
Windows Server 2012 R2
Ende des Supports (Server)
Windows Server 2012 R2
IDL
SbTsV.idl
IID
IID_ITsSbResourcePluginStoreEx ist definiert als 80b83ffd-625d-11e5-bea1-a0481c7e9064

Siehe auch

ITsSbResourcePluginStoreEx