次の方法で共有


ZwOpenTransactionManager 関数 (wdm.h)

ZwOpenTransactionManager ルーチンは、既存のトランザクション マネージャー オブジェクトへのハンドルを取得します。

構文

NTSYSCALLAPI NTSTATUS ZwOpenTransactionManager(
  [out]          PHANDLE            TmHandle,
  [in]           ACCESS_MASK        DesiredAccess,
  [in, optional] POBJECT_ATTRIBUTES ObjectAttributes,
  [in, optional] PUNICODE_STRING    LogFileName,
  [in, optional] LPGUID             TmIdentity,
  [in, optional] ULONG              OpenOptions
);

パラメーター

[out] TmHandle

ZwOpenTransactionManager がSTATUS_SUCCESSを返した場合にトランザクション マネージャー オブジェクトへのハンドルを受け取る呼び出し元割り当て変数へのポインター。

[in] DesiredAccess

トランザクション マネージャー オブジェクトへの呼び出し元の要求されたアクセスを指定するACCESS_MASK値。 このパラメーターを指定する方法については、ZwCreateTransactionManagerDesiredAccess パラメーターを参照してください。

[in, optional] ObjectAttributes

オブジェクト名とその他の属性を指定する OBJECT_ATTRIBUTES 構造体へのポインター。 InitializeObjectAttributes ルーチンを使用して、この構造体を初期化します。 呼び出し元がシステム スレッド コンテキストで実行されていない場合は、 InitializeObjectAttributes を呼び出すときにOBJ_KERNEL_HANDLE属性を設定する必要があります。 このパラメーターは省略可能であり、 NULL にすることができます

[in, optional] LogFileName

トランザクション マネージャー オブジェクトの作成時 に作成された ログ ファイル ストリーム のパスとファイル名を含むUNICODE_STRING構造体へのポインター。 詳細については、ZwCreateTransactionManagerLogFileName パラメーターを参照してください。 このパラメーターは省略可能であり、 NULL にすることができます

[in, optional] TmIdentity

トランザクション マネージャー オブジェクトを識別する GUID へのポインター。 このパラメーターは省略可能であり、 NULL にすることができます

[in, optional] OpenOptions

このパラメーターは使われていないので、0 にする必要があります。

戻り値

操作が成功した場合、ZwOpenTransactionManager はSTATUS_SUCCESSを返します。 それ以外の場合、このルーチンは次のいずれかの値を返す可能性があります。

リターン コード 説明
STATUS_INVALID_PARAMETER
入力パラメーターの値が無効です。
STATUS_INSUFFICIENT_RESOURCES
KTM はシステム リソース (通常はメモリ) を割り当てませんでした。
STATUS_OBJECT_NAME_INVALID
ObjectAttributes パラメーターが指定するオブジェクト名が無効です。
STATUS_LOG_CORRUPTION_DETECTED
KTM でログ ファイルの作成中または開いている間にエラーが発生しました。
STATUS_ACCESS_DENIED
DesiredAccess パラメーターの値が無効です。
 

ルーチンは、他の NTSTATUS 値を返す場合があります。

注釈

呼び出し元は、次の 3 つの手法のいずれかを使用して、開くトランザクション マネージャー オブジェクトを識別できます。

  • LogFileName パラメーターを使用して、トランザクション マネージャー オブジェクトの作成時に作成されたログ ファイル ストリームのパスとファイル名を指定します。
  • TmIdentity パラメーターを使用して、トランザクション マネージャー オブジェクトを識別する GUID を指定します。
  • ObjectAttributes パラメーターを使用して呼び出し元が以前に ZwCreateTransactionManager ルーチンに指定したオブジェクト名を含むOBJECT_ATTRIBUTES構造体を指定します。
上記のいずれかのパラメーター (オブジェクト名、ログ ファイル名、または GUID) のみを指定し、他の 2 つのパラメーターを NULL に設定する必要があります。

TPS コンポーネントは 、ZwOpenTransactionManager を 呼び出した後、 ZwRecoverTransactionManager を呼び出す必要があります。

ZwOpenTransactionManager を呼び出す TPS コンポーネントは、オブジェクト ハンドルを閉じるには、最終的に ZwClose を呼び出す必要があります。

ZwOpenTransactionManager の使用方法の詳細については、「Transaction Manager オブジェクト」および「Resource Managerの作成」を参照してください。

NtOpenTransactionManagerZwOpenTransactionManager は、同じ Windows ネイティブ システム サービス ルーチンの 2 つのバージョンです。

カーネル モード ドライバーからの呼び出しの場合、Windows ネイティブ システム サービス ルーチンの NtXxx および ZwXxx バージョンは、入力パラメーターを処理および解釈する方法で動作が異なる場合があります。 ルーチンの NtXxx バージョンと ZwXxx バージョンの間の関係の詳細については、「ネイティブ システム サービス ルーチンの Nt バージョンと Zw バージョンの使用」を参照してください。

要件

要件
サポートされている最小のクライアント Windows Vista 以降のオペレーティング システム バージョンで使用できます。
対象プラットフォーム ユニバーサル
Header wdm.h (Wdm.h、Ntifs.h を含む)
Library NtosKrnl.lib
[DLL] NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

こちらもご覧ください

InitializeObjectAttributes

OBJECT_ATTRIBUTES

UNICODE_STRING

Nt および Zw バージョンのネイティブ システム サービス ルーチンの使用

ZwClose

ZwCreateTransactionManager

ZwQueryInformationTransactionManager