Win32 API 日本語リファレンス
ホームStorage.FileSystem › CreateLogFile

CreateLogFile

関数
CLFSのログファイルを作成または開く。
DLLclfsw32.dll呼出規約winapiSetLastErrorあり対応OSWindows Vista 以降

シグネチャ

// 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
);

パラメーター

名前方向
pszLogFileNameLPCWSTRin
fDesiredAccessDWORDin
dwShareModeFILE_SHARE_MODEin
psaLogFileSECURITY_ATTRIBUTES*inout
fCreateDispositionFILE_CREATION_DISPOSITIONin
fFlagsAndAttributesFILE_FLAGS_AND_ATTRIBUTESin

戻り値の型: 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 方式にも切替可。
出力引数:
; 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 方式にも切替可。
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   // HANDLE
function 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)。