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