OpenTransaction 関数 (ktmw32.h)

既存のトランザクションを開きます。

構文

HANDLE OpenTransaction(
  [in] DWORD  dwDesiredAccess,
  [in] LPGUID TransactionId
);

[in] dwDesiredAccess

トランザクションオブジェクトへのアクセス。トランザクションを操作するには、読み取りおよび書き込みアクセス権が必要です。有効な値の一覧については、「トランザクションアクセスマスク」を参照してください。

[in] TransactionId

開くトランザクションを識別する GUID。これは一般に、トランザクションの作業単位と呼ばれます。

関数が成功した場合、戻り値はトランザクションへのハンドルです。

失敗した場合の戻り値は、INVALID_HANDLE_VALUE です。エラーの詳細情報を得るには、GetLastError 関数を呼び出します。

次の一覧は、考えられるエラーコードを示しています。

クライアントは CloseHandle 関数を使用してトランザクションハンドルを閉じます。トランザクションで CommitTransaction 関数を呼び出さずに最後のトランザクションハンドルを閉じると、KTM はトランザクションを暗黙的にロールバックします。