InstancePersistenceContext.BeginBindReclaimedLock Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Beginnen einen asynchronen Vorgang, um eine vorhandene Sperre auf einer Instanz an das aktuelle Instanzhandle zu binden. Die Version der vorhandenen Sperre wird als Parameter übergeben.
public:
IAsyncResult ^ BeginBindReclaimedLock(long instanceVersion, TimeSpan timeout, AsyncCallback ^ callback, System::Object ^ state);public IAsyncResult BeginBindReclaimedLock (long instanceVersion, TimeSpan timeout, AsyncCallback callback, object state);member this.BeginBindReclaimedLock : int64 * TimeSpan * AsyncCallback * obj -> IAsyncResultPublic Function BeginBindReclaimedLock (instanceVersion As Long, timeout As TimeSpan, callback As AsyncCallback, state As Object) As IAsyncResultParameter
- instanceVersion
- Int64
Die Version der Sperre, die für die Instanz gehalten wird, oder 0 (null), wenn der Persistenzanbieter keine Sperrversionen implementiert.
- timeout
- TimeSpan
Das Zeitlimit für den asynchronen Vorgang.
- callback
- AsyncCallback
Die Methode, die aufgerufen werden soll, wenn der Vorgang abgeschlossen ist.
- state
- Object
Die dem asynchronen Vorgang zugeordneten Statusinformationen.
Gibt zurück
Der Status eines asynchronen Vorgangs.
Hinweise
Beim Versuch, eine Sperre festzulegen, kann der Persistenzanbieter entscheiden, dass die aktuelle Instanz bereits im aktuellen Speicher gesperrt ist. Wenn das Sperrtoken mit dem Sperrtoken des aktuellen Handles übereinstimmt, kann der Persistenzanbieter versuchen, die Sperre wieder aufzunehmen, indem er seine Version überprüft und an BeginBindReclaimedLock übergibt. Der Persistenzanbieter darf erst Änderungen an der Instanz vornehmen, wenn die Sperre erfolgreich freigegeben wurde. Wenn kein anderes Handle an die Sperre gebunden ist, ist der BeginBindReclaimedLock-Vorgang erfolgreich, und das aktuelle Handle wird an die Sperre gebunden. Andernfalls löst BeginBindReclaimedLock oder EndBindReclaimedLock die Ausnahme InstanceHandleConflictException aus. Wenn Befehle für andere Handles in Bearbeitung sind, wird der Vorgang möglicherweise nicht abgeschlossen, um auf das Ergebnis dieser Befehle zu warten, bevor über die Freigabe der Sperre entschieden wird.
Das aktuelle Instanzhandle muss an einen Instanz- und einen Sperrbesitzer gebunden sein. Die Instanz darf nicht abgeschlossen sein. Das dem Sperrbesitzer zugeordnete Sperrtoken wird verwendet, um den Besitzer der Sperre zu identifizieren.
Sobald eine Sperre an ein Handle gebunden wird, bleibt diese für die Lebensdauer des Handles gebunden. Weder das Sperrtoken noch die Instanzversion kann geändert werden.