OpenFileMappingW

名前付きファイルマッピングオブジェクトを開く。(OpenFileMappingW)

OpenFileMappingW dwDesiredAccess, bInheritHandle, lpName

dwDesiredAccess : [int] ファイルマッピングオブジェクトへのアクセス。このアクセスは対象のファイルマッピングオブジェクトの任意のセキュリティ記述子と照合される。値の一覧は「ファイルマッピングのセキュリティとアクセス権」を参照。
bInheritHandle : [int] この引数が TRUE の場合、CreateProcess 関数で作成されたプロセスはハンドルを継承できる。そうでない場合、ハンドルは継承できない。
lpName : [wstr] 開くファイルマッピングオブジェクトの名前。この名前を持つファイルマッピングオブジェクトへの開いているハンドルがあり、マッピングオブジェクトのセキュリティ記述子が dwDesiredAccess 引数と競合しない場合、オープン操作は成功する。名前は "Global\" または "Local\" プレフィックスを持つことができ、グローバル名前空間またはセッション名前空間にあるオブジェクトを明示的に開ける。名前の残り部分にはバックスラッシュ (\\) 以外の任意の文字を含められる。詳細は「カーネルオブジェクト名前空間」を参照。ファーストユーザー切り替えはターミナルサービスセッションを使って実装される。最初にログオンしたユーザーはセッション 0 を使用し、次のユーザーはセッション 1 を使用する、というように続く。アプリケーションが複数ユーザーをサポートできるよう、カーネルオブジェクト名はターミナルサービス向けのガイドラインに従わなければならない。

(プラグイン / モジュール : kernel32.dll)

解説

名前付きファイルマッピングオブジェクトを開く。(OpenFileMappingW)

[戻り値]
関数が成功した場合、戻り値は指定したファイルマッピングオブジェクトの開かれたハンドルである。関数が失敗した場合、戻り値は NULL
である。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
OpenFileMapping
が返すハンドルは、ファイルマッピングオブジェクトのハンドルを要求する任意の関数で使用できる。マップされたビューを介してファイルを変更する場合、最終更新タイムスタンプが自動的には更新されないことがある。必要であれば、呼び出し側は
SetFileTime を使ってタイムスタンプを設定すべきである。OpenFileMapping
が返したハンドルが不要になったら、呼び出し側は CloseHandle を呼んでハンドルを解放すべきである。Windows Server
2012 では、この関数は次のテクノロジによってサポートされる。
（以下省略）

情報