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 |