Freigeben über


InstancePersistenceContext.BeginBindReclaimedLock Methode

Definition

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 -> IAsyncResult
Public Function BeginBindReclaimedLock (instanceVersion As Long, timeout As TimeSpan, callback As AsyncCallback, state As Object) As IAsyncResult

Parameter

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

IAsyncResult

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.

Gilt für