MemoryMappedFile.CreateOrOpen メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
システム メモリ内でメモリ マップト ファイルを作成するか、または開きます。
オーバーロード
| CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, MemoryMappedFileSecurity, HandleInheritability) |
名前、容量、アクセスの種類、メモリの割り当て、セキュリティ アクセス許可、継承性が指定されたメモリ マップト ファイルをシステム メモリ内で作成するか、開きます。 |
| CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability) |
新しい空のメモリ マップト ファイルを作成するか、同じ名前のファイルが存在する場合は既存のメモリ マップト ファイルを開きます。 既存のファイルを開く場合、容量、オプション、およびメモリ引数は無視されます。 |
| CreateOrOpen(String, Int64) |
名前と容量が指定されたメモリ マップト ファイルをシステム メモリ内で作成するか、開きます。 |
| CreateOrOpen(String, Int64, MemoryMappedFileAccess) |
名前、容量、アクセスの種類が指定されたメモリ マップト ファイルをシステム メモリ内で作成するか、開きます。 |
CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, MemoryMappedFileSecurity, HandleInheritability)
名前、容量、アクセスの種類、メモリの割り当て、セキュリティ アクセス許可、継承性が指定されたメモリ マップト ファイルをシステム メモリ内で作成するか、開きます。
public:
static System::IO::MemoryMappedFiles::MemoryMappedFile ^ CreateOrOpen(System::String ^ mapName, long capacity, System::IO::MemoryMappedFiles::MemoryMappedFileAccess access, System::IO::MemoryMappedFiles::MemoryMappedFileOptions options, System::IO::MemoryMappedFiles::MemoryMappedFileSecurity ^ memoryMappedFileSecurity, System::IO::HandleInheritability inheritability);[System.Security.SecurityCritical]
public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen (string mapName, long capacity, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access, System.IO.MemoryMappedFiles.MemoryMappedFileOptions options, System.IO.MemoryMappedFiles.MemoryMappedFileSecurity memoryMappedFileSecurity, System.IO.HandleInheritability inheritability);[<System.Security.SecurityCritical>]
static member CreateOrOpen : string * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess * System.IO.MemoryMappedFiles.MemoryMappedFileOptions * System.IO.MemoryMappedFiles.MemoryMappedFileSecurity * System.IO.HandleInheritability -> System.IO.MemoryMappedFiles.MemoryMappedFilePublic Shared Function CreateOrOpen (mapName As String, capacity As Long, access As MemoryMappedFileAccess, options As MemoryMappedFileOptions, memoryMappedFileSecurity As MemoryMappedFileSecurity, inheritability As HandleInheritability) As MemoryMappedFileパラメーター
- mapName
- String
メモリ マップト ファイルの名前。
- capacity
- Int64
メモリ マップト ファイルに割り当てる最大サイズ (バイト単位)。
- access
- MemoryMappedFileAccess
メモリ マップト ファイルに対して許可されたアクセス権の種類を指定する列挙値の 1 つ。 既定値は、ReadWrite です。
- options
- MemoryMappedFileOptions
メモリ マップト ファイルのメモリ割り当てオプションを指定する列挙値のビットごとの組み合わせ。
- memoryMappedFileSecurity
- MemoryMappedFileSecurity
メモリ マップト ファイルに対するファイル アクセスと操作に関して付与することのできるアクセス許可。
このパラメーターは、null に設定できます。
- inheritability
- HandleInheritability
メモリ マップト ファイルへのハンドルを子プロセスが継承できるかどうかを指定する列挙値の 1 つ。 既定値は、None です。
戻り値
指定された特性を持つメモリ マップト ファイル。
- 属性
例外
mapName は null です。
capacity が論理アドレス空間のサイズを超えています。
- または -
capacity が 0 以下です。
- または -
access が有効な MemoryMappedFileAccess 列挙値ではありません。
- または -
inheritability が有効な HandleInheritability 列挙値ではありません。
オペレーティング システムが、ファイルに指定した access を拒否しました。たとえば、access が Write または ReadWrite に設定されていますが、ファイルまたはディレクトリが読み取り専用です。
注釈
永続化されていない (つまり、ディスク上のファイルに関連付けられていない) メモリ マップト ファイルを作成または開くには、このメソッドを使用します。これは、プロセス間でデータを共有するために使用できます。
こちらもご覧ください
適用対象
CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability)
新しい空のメモリ マップト ファイルを作成するか、同じ名前のファイルが存在する場合は既存のメモリ マップト ファイルを開きます。 既存のファイルを開く場合、容量、オプション、およびメモリ引数は無視されます。
public:
static System::IO::MemoryMappedFiles::MemoryMappedFile ^ CreateOrOpen(System::String ^ mapName, long capacity, System::IO::MemoryMappedFiles::MemoryMappedFileAccess access, System::IO::MemoryMappedFiles::MemoryMappedFileOptions options, System::IO::HandleInheritability inheritability);[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen (string mapName, long capacity, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access, System.IO.MemoryMappedFiles.MemoryMappedFileOptions options, System.IO.HandleInheritability inheritability);public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen (string mapName, long capacity, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access, System.IO.MemoryMappedFiles.MemoryMappedFileOptions options, System.IO.HandleInheritability inheritability);[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member CreateOrOpen : string * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess * System.IO.MemoryMappedFiles.MemoryMappedFileOptions * System.IO.HandleInheritability -> System.IO.MemoryMappedFiles.MemoryMappedFilestatic member CreateOrOpen : string * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess * System.IO.MemoryMappedFiles.MemoryMappedFileOptions * System.IO.HandleInheritability -> System.IO.MemoryMappedFiles.MemoryMappedFilePublic Shared Function CreateOrOpen (mapName As String, capacity As Long, access As MemoryMappedFileAccess, options As MemoryMappedFileOptions, inheritability As HandleInheritability) As MemoryMappedFileパラメーター
- mapName
- String
メモリ マップト ファイルの名前。
- capacity
- Int64
メモリ マップト ファイルに割り当てる最大サイズ (バイト単位)。
- access
- MemoryMappedFileAccess
メモリ マップト ファイルに対して許可されたアクセス権の種類を指定する列挙値の 1 つ。 既定値は、ReadWrite です。
- options
- MemoryMappedFileOptions
ファイルに適用するメモリ割り当てオプションを示す値のビットごとの組み合わせ。
- inheritability
- HandleInheritability
メモリ マップト ファイルへのハンドルを子プロセスが継承できるかどうかを指定する値。 既定値は、None です。
戻り値
指定された特性を持つメモリ マップト ファイル。
- 属性
例外
mapName は null です。
capacity が論理アドレス空間のサイズを超えています。
- または -
capacity が 0 以下です。
- または -
access が有効な MemoryMappedFileAccess 列挙値ではありません。
- または -
inheritability が有効な HandleInheritability 列挙値ではありません。
オペレーティング システムが、ファイルに指定したアクセスを拒否しました。たとえば、アクセスが Write または ReadWrite に設定されていますが、ファイルまたはディレクトリが読み取り専用です。
適用対象
CreateOrOpen(String, Int64)
名前と容量が指定されたメモリ マップト ファイルをシステム メモリ内で作成するか、開きます。
public:
static System::IO::MemoryMappedFiles::MemoryMappedFile ^ CreateOrOpen(System::String ^ mapName, long capacity);[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen (string mapName, long capacity);public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen (string mapName, long capacity);[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member CreateOrOpen : string * int64 -> System.IO.MemoryMappedFiles.MemoryMappedFilestatic member CreateOrOpen : string * int64 -> System.IO.MemoryMappedFiles.MemoryMappedFilePublic Shared Function CreateOrOpen (mapName As String, capacity As Long) As MemoryMappedFileパラメーター
- mapName
- String
メモリ マップト ファイルの名前。
- capacity
- Int64
メモリ マップト ファイルに割り当てる最大サイズ (バイト単位)。
戻り値
指定された名前およびサイズのメモリ マップト ファイル。
- 属性
例外
mapName が空の文字列です。
注釈
永続化されていない (つまり、ディスク上のファイルに関連付けられていない) メモリ マップト ファイルを作成または開くには、このメソッドを使用します。これは、プロセス間でデータを共有するために使用できます。
こちらもご覧ください
適用対象
CreateOrOpen(String, Int64, MemoryMappedFileAccess)
名前、容量、アクセスの種類が指定されたメモリ マップト ファイルをシステム メモリ内で作成するか、開きます。
public:
static System::IO::MemoryMappedFiles::MemoryMappedFile ^ CreateOrOpen(System::String ^ mapName, long capacity, System::IO::MemoryMappedFiles::MemoryMappedFileAccess access);[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen (string mapName, long capacity, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access);public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen (string mapName, long capacity, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access);[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member CreateOrOpen : string * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedFilestatic member CreateOrOpen : string * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedFilePublic Shared Function CreateOrOpen (mapName As String, capacity As Long, access As MemoryMappedFileAccess) As MemoryMappedFileパラメーター
- mapName
- String
メモリ マップト ファイルの名前。
- capacity
- Int64
メモリ マップト ファイルに割り当てる最大サイズ (バイト単位)。
- access
- MemoryMappedFileAccess
メモリ マップト ファイルに対して許可されたアクセス権の種類を指定する列挙値の 1 つ。 既定値は、ReadWrite です。
戻り値
指定された特性を持つメモリ マップト ファイル。
- 属性
例外
mapName は null です。
capacity が論理アドレス空間のサイズを超えています。
- または -
capacity が 0 以下です。
- または -
access が有効な MemoryMappedFileAccess 列挙値ではありません。
オペレーティング システムが、ファイルに指定したアクセスを拒否しました。たとえば、アクセスが Write または ReadWrite に設定されていますが、ファイルまたはディレクトリが読み取り専用です。
注釈
永続化されていない (つまり、ディスク上のファイルに関連付けられていない) メモリ マップト ファイルを作成または開くには、このメソッドを使用します。これは、プロセス間でデータを共有するために使用できます。
こちらもご覧ください
適用対象
.NET