ホーム › Storage.FileSystem › CreateFile2
CreateFile2
関数拡張パラメータを指定してファイルを作成または開く。
シグネチャ
// KERNEL32.dll
#include <windows.h>
HANDLE CreateFile2(
LPCWSTR lpFileName,
DWORD dwDesiredAccess,
FILE_SHARE_MODE dwShareMode,
FILE_CREATION_DISPOSITION dwCreationDisposition,
CREATEFILE2_EXTENDED_PARAMETERS* pCreateExParams // optional
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| lpFileName | LPCWSTR | in |
| dwDesiredAccess | DWORD | in |
| dwShareMode | FILE_SHARE_MODE | in |
| dwCreationDisposition | FILE_CREATION_DISPOSITION | in |
| pCreateExParams | CREATEFILE2_EXTENDED_PARAMETERS* | inoptional |
戻り値の型: HANDLE
各言語での呼び出し定義
// KERNEL32.dll
#include <windows.h>
HANDLE CreateFile2(
LPCWSTR lpFileName,
DWORD dwDesiredAccess,
FILE_SHARE_MODE dwShareMode,
FILE_CREATION_DISPOSITION dwCreationDisposition,
CREATEFILE2_EXTENDED_PARAMETERS* pCreateExParams // optional
);[DllImport("KERNEL32.dll", SetLastError = true, ExactSpelling = true)]
static extern IntPtr CreateFile2(
[MarshalAs(UnmanagedType.LPWStr)] string lpFileName, // LPCWSTR
uint dwDesiredAccess, // DWORD
uint dwShareMode, // FILE_SHARE_MODE
uint dwCreationDisposition, // FILE_CREATION_DISPOSITION
IntPtr pCreateExParams // CREATEFILE2_EXTENDED_PARAMETERS* optional
);<DllImport("KERNEL32.dll", SetLastError:=True, ExactSpelling:=True)>
Public Shared Function CreateFile2(
<MarshalAs(UnmanagedType.LPWStr)> lpFileName As String, ' LPCWSTR
dwDesiredAccess As UInteger, ' DWORD
dwShareMode As UInteger, ' FILE_SHARE_MODE
dwCreationDisposition As UInteger, ' FILE_CREATION_DISPOSITION
pCreateExParams As IntPtr ' CREATEFILE2_EXTENDED_PARAMETERS* optional
) As IntPtr
End Function' lpFileName : LPCWSTR
' dwDesiredAccess : DWORD
' dwShareMode : FILE_SHARE_MODE
' dwCreationDisposition : FILE_CREATION_DISPOSITION
' pCreateExParams : CREATEFILE2_EXTENDED_PARAMETERS* optional
Declare PtrSafe Function CreateFile2 Lib "kernel32" ( _
ByVal lpFileName As LongPtr, _
ByVal dwDesiredAccess As Long, _
ByVal dwShareMode As Long, _
ByVal dwCreationDisposition As Long, _
ByVal pCreateExParams As LongPtr) As LongPtr
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
CreateFile2 = ctypes.windll.kernel32.CreateFile2
CreateFile2.restype = ctypes.c_void_p
CreateFile2.argtypes = [
wintypes.LPCWSTR, # lpFileName : LPCWSTR
wintypes.DWORD, # dwDesiredAccess : DWORD
wintypes.DWORD, # dwShareMode : FILE_SHARE_MODE
wintypes.DWORD, # dwCreationDisposition : FILE_CREATION_DISPOSITION
ctypes.c_void_p, # pCreateExParams : CREATEFILE2_EXTENDED_PARAMETERS* optional
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('KERNEL32.dll')
CreateFile2 = Fiddle::Function.new(
lib['CreateFile2'],
[
Fiddle::TYPE_VOIDP, # lpFileName : LPCWSTR
-Fiddle::TYPE_INT, # dwDesiredAccess : DWORD
-Fiddle::TYPE_INT, # dwShareMode : FILE_SHARE_MODE
-Fiddle::TYPE_INT, # dwCreationDisposition : FILE_CREATION_DISPOSITION
Fiddle::TYPE_VOIDP, # pCreateExParams : CREATEFILE2_EXTENDED_PARAMETERS* optional
],
Fiddle::TYPE_VOIDP)#[link(name = "kernel32")]
extern "system" {
fn CreateFile2(
lpFileName: *const u16, // LPCWSTR
dwDesiredAccess: u32, // DWORD
dwShareMode: u32, // FILE_SHARE_MODE
dwCreationDisposition: u32, // FILE_CREATION_DISPOSITION
pCreateExParams: *mut CREATEFILE2_EXTENDED_PARAMETERS // CREATEFILE2_EXTENDED_PARAMETERS* optional
) -> *mut core::ffi::c_void;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("KERNEL32.dll", SetLastError = true)]
public static extern IntPtr CreateFile2([MarshalAs(UnmanagedType.LPWStr)] string lpFileName, uint dwDesiredAccess, uint dwShareMode, uint dwCreationDisposition, IntPtr pCreateExParams);
"@
$api = Add-Type -MemberDefinition $sig -Name 'KERNEL32_CreateFile2' -Namespace Win32 -PassThru
# $api::CreateFile2(lpFileName, dwDesiredAccess, dwShareMode, dwCreationDisposition, pCreateExParams)#uselib "KERNEL32.dll"
#func global CreateFile2 "CreateFile2" sptr, sptr, sptr, sptr, sptr
; CreateFile2 lpFileName, dwDesiredAccess, dwShareMode, dwCreationDisposition, varptr(pCreateExParams) ; 戻り値は stat
; lpFileName : LPCWSTR -> "sptr"
; dwDesiredAccess : DWORD -> "sptr"
; dwShareMode : FILE_SHARE_MODE -> "sptr"
; dwCreationDisposition : FILE_CREATION_DISPOSITION -> "sptr"
; pCreateExParams : CREATEFILE2_EXTENDED_PARAMETERS* optional -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "KERNEL32.dll" #cfunc global CreateFile2 "CreateFile2" wstr, int, int, int, var ; res = CreateFile2(lpFileName, dwDesiredAccess, dwShareMode, dwCreationDisposition, pCreateExParams) ; lpFileName : LPCWSTR -> "wstr" ; dwDesiredAccess : DWORD -> "int" ; dwShareMode : FILE_SHARE_MODE -> "int" ; dwCreationDisposition : FILE_CREATION_DISPOSITION -> "int" ; pCreateExParams : CREATEFILE2_EXTENDED_PARAMETERS* optional -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "KERNEL32.dll" #cfunc global CreateFile2 "CreateFile2" wstr, int, int, int, sptr ; res = CreateFile2(lpFileName, dwDesiredAccess, dwShareMode, dwCreationDisposition, varptr(pCreateExParams)) ; lpFileName : LPCWSTR -> "wstr" ; dwDesiredAccess : DWORD -> "int" ; dwShareMode : FILE_SHARE_MODE -> "int" ; dwCreationDisposition : FILE_CREATION_DISPOSITION -> "int" ; pCreateExParams : CREATEFILE2_EXTENDED_PARAMETERS* optional -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; HANDLE CreateFile2(LPCWSTR lpFileName, DWORD dwDesiredAccess, FILE_SHARE_MODE dwShareMode, FILE_CREATION_DISPOSITION dwCreationDisposition, CREATEFILE2_EXTENDED_PARAMETERS* pCreateExParams) #uselib "KERNEL32.dll" #cfunc global CreateFile2 "CreateFile2" wstr, int, int, int, var ; res = CreateFile2(lpFileName, dwDesiredAccess, dwShareMode, dwCreationDisposition, pCreateExParams) ; lpFileName : LPCWSTR -> "wstr" ; dwDesiredAccess : DWORD -> "int" ; dwShareMode : FILE_SHARE_MODE -> "int" ; dwCreationDisposition : FILE_CREATION_DISPOSITION -> "int" ; pCreateExParams : CREATEFILE2_EXTENDED_PARAMETERS* optional -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; HANDLE CreateFile2(LPCWSTR lpFileName, DWORD dwDesiredAccess, FILE_SHARE_MODE dwShareMode, FILE_CREATION_DISPOSITION dwCreationDisposition, CREATEFILE2_EXTENDED_PARAMETERS* pCreateExParams) #uselib "KERNEL32.dll" #cfunc global CreateFile2 "CreateFile2" wstr, int, int, int, intptr ; res = CreateFile2(lpFileName, dwDesiredAccess, dwShareMode, dwCreationDisposition, varptr(pCreateExParams)) ; lpFileName : LPCWSTR -> "wstr" ; dwDesiredAccess : DWORD -> "int" ; dwShareMode : FILE_SHARE_MODE -> "int" ; dwCreationDisposition : FILE_CREATION_DISPOSITION -> "int" ; pCreateExParams : CREATEFILE2_EXTENDED_PARAMETERS* optional -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
kernel32 = windows.NewLazySystemDLL("KERNEL32.dll")
procCreateFile2 = kernel32.NewProc("CreateFile2")
)
// lpFileName (LPCWSTR), dwDesiredAccess (DWORD), dwShareMode (FILE_SHARE_MODE), dwCreationDisposition (FILE_CREATION_DISPOSITION), pCreateExParams (CREATEFILE2_EXTENDED_PARAMETERS* optional)
r1, _, err := procCreateFile2.Call(
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(lpFileName))),
uintptr(dwDesiredAccess),
uintptr(dwShareMode),
uintptr(dwCreationDisposition),
uintptr(pCreateExParams),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // HANDLEfunction CreateFile2(
lpFileName: PWideChar; // LPCWSTR
dwDesiredAccess: DWORD; // DWORD
dwShareMode: DWORD; // FILE_SHARE_MODE
dwCreationDisposition: DWORD; // FILE_CREATION_DISPOSITION
pCreateExParams: Pointer // CREATEFILE2_EXTENDED_PARAMETERS* optional
): THandle; stdcall;
external 'KERNEL32.dll' name 'CreateFile2';result := DllCall("KERNEL32\CreateFile2"
, "WStr", lpFileName ; LPCWSTR
, "UInt", dwDesiredAccess ; DWORD
, "UInt", dwShareMode ; FILE_SHARE_MODE
, "UInt", dwCreationDisposition ; FILE_CREATION_DISPOSITION
, "Ptr", pCreateExParams ; CREATEFILE2_EXTENDED_PARAMETERS* optional
, "Ptr") ; return: HANDLE●CreateFile2(lpFileName, dwDesiredAccess, dwShareMode, dwCreationDisposition, pCreateExParams) = DLL("KERNEL32.dll", "void* CreateFile2(char*, dword, dword, dword, void*)")
# 呼び出し: CreateFile2(lpFileName, dwDesiredAccess, dwShareMode, dwCreationDisposition, pCreateExParams)
# lpFileName : LPCWSTR -> "char*"
# dwDesiredAccess : DWORD -> "dword"
# dwShareMode : FILE_SHARE_MODE -> "dword"
# dwCreationDisposition : FILE_CREATION_DISPOSITION -> "dword"
# pCreateExParams : CREATEFILE2_EXTENDED_PARAMETERS* optional -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。