Share via

ObjectContext::IsInTransaction-Methode (comsvcs.h)

  • Artikel

Gibt an, ob das aktuelle Objekt in einer Transaktion ausgeführt wird.

Syntax

HRESULT IsInTransaction(
  [out] VARIANT_BOOL *pbIsInTx
);

Parameter

[out] pbIsInTx

TRUE , wenn das aktuelle Objekt innerhalb einer Transaktion ausgeführt wird; Andernfalls FALSE .

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY und E_FAIL sowie die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich abgeschlossen.
E_UNEXPECTED
 Ein unerwarteter Fehler ist aufgetreten. Dies kann passieren, wenn ein Objekt seinen ObjectContext-Zeiger an ein anderes Objekt übergibt und das andere Objekt IsInTransaction mit diesem Zeiger aufruft. Ein ObjectContext-Zeiger ist außerhalb des Kontexts des Objekts, das ihn ursprünglich abgerufen hat, ungültig.

Hinweise

Sie können diese Methode verwenden, um sicherzustellen, dass ein Objekt, das eine Transaktion erfordert, niemals ohne eine ausgeführt wird. Wenn beispielsweise eine Komponente, die eine Transaktion erfordert, im Verwaltungstool für Komponentendienste falsch konfiguriert ist, können Sie diese Methode verwenden, um zu bestimmen, dass das Objekt keine Transaktion aufweist. Anschließend können Sie einen Fehler zurückgeben, um den Benutzer auf das Problem hinzuweisen oder eine beliebige geeignete Aktion zu ergreifen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile comsvcs.h

Weitere Informationen

Objectcontext