ITransactionContextEx::CreateInstance-Methode (comsvcs.h)

Erstellt ein COM-Objekt, das innerhalb des Bereichs der Transaktion ausgeführt werden kann, die vom Transaktionskontextobjekt initiiert wurde.

Syntax

HRESULT CreateInstance(
  [in]  REFCLSID rclsid,
  [in]  REFIID   riid,
  [out] void     **pObject
);

Parameter

[in] rclsid

Ein Verweis auf die CLSID des Typs des zu instanziierenden Objekts.

[in] riid

Ein Verweis auf die Schnittstellen-ID der Schnittstelle, über die Sie mit dem neuen Objekt kommunizieren.

[out] pObject

Ein Verweis auf ein neues Objekt des typs, der vom rclsid-Parameter über die durch den riid-Parameter angegebene Schnittstelle angegeben wird.

Rückgabewert

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

Hinweise

Wenn der Microsoft Distributed Transaction Coordinator nicht ausgeführt wird und das Objekt transaktional ist, wird das Objekt erfolgreich erstellt. Methodenaufrufe für dieses Objekt schlagen jedoch mit CONTEXT_E_TMNOTAVAILABLE fehl. Objekte können von dieser Bedingung nicht wiederhergestellt werden und sollten freigegeben werden.

Beispiele

ITransactionContextEx* pTransactionContext = NULL;
IMyObject* pMyObject = NULL;
HRESULT hr;

// Get TransactionContextEx.
hr = CoCreateInstance(CLSID_TransactionContextEx, 
  NULL, CLSCTX_INPROC, IID_ITransactionContextEx, 
  (void**)&pTransactionContext);
if (FAILED(hr)) throw(hr);

// Create an instance of MyObject.
hr = pTransactionContext->CreateInstance(CLSID_CMyObject, 
  IID_IMyObject, (void**)&pMyObject);
if (FAILED(hr)) throw(hr);

Anforderungen

Weitere Informationen

ITransactionContextEx