ホーム › Storage.FileSystem › FindFirstFileTransactedW
FindFirstFileTransactedW
関数トランザクション内でファイル検索を開始する(Unicode版)。
シグネチャ
// KERNEL32.dll (Unicode / -W)
#include <windows.h>
HANDLE FindFirstFileTransactedW(
LPCWSTR lpFileName,
FINDEX_INFO_LEVELS fInfoLevelId,
void* lpFindFileData,
FINDEX_SEARCH_OPS fSearchOp,
void* lpSearchFilter, // optional
DWORD dwAdditionalFlags,
HANDLE hTransaction
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| lpFileName | LPCWSTR | in |
| fInfoLevelId | FINDEX_INFO_LEVELS | in |
| lpFindFileData | void* | out |
| fSearchOp | FINDEX_SEARCH_OPS | in |
| lpSearchFilter | void* | optional |
| dwAdditionalFlags | DWORD | in |
| hTransaction | HANDLE | in |
戻り値の型: HANDLE
各言語での呼び出し定義
// KERNEL32.dll (Unicode / -W)
#include <windows.h>
HANDLE FindFirstFileTransactedW(
LPCWSTR lpFileName,
FINDEX_INFO_LEVELS fInfoLevelId,
void* lpFindFileData,
FINDEX_SEARCH_OPS fSearchOp,
void* lpSearchFilter, // optional
DWORD dwAdditionalFlags,
HANDLE hTransaction
);[DllImport("KERNEL32.dll", CharSet = CharSet.Unicode, SetLastError = true, ExactSpelling = true)]
static extern IntPtr FindFirstFileTransactedW(
[MarshalAs(UnmanagedType.LPWStr)] string lpFileName, // LPCWSTR
int fInfoLevelId, // FINDEX_INFO_LEVELS
IntPtr lpFindFileData, // void* out
int fSearchOp, // FINDEX_SEARCH_OPS
IntPtr lpSearchFilter, // void* optional
uint dwAdditionalFlags, // DWORD
IntPtr hTransaction // HANDLE
);<DllImport("KERNEL32.dll", CharSet:=CharSet.Unicode, SetLastError:=True, ExactSpelling:=True)>
Public Shared Function FindFirstFileTransactedW(
<MarshalAs(UnmanagedType.LPWStr)> lpFileName As String, ' LPCWSTR
fInfoLevelId As Integer, ' FINDEX_INFO_LEVELS
lpFindFileData As IntPtr, ' void* out
fSearchOp As Integer, ' FINDEX_SEARCH_OPS
lpSearchFilter As IntPtr, ' void* optional
dwAdditionalFlags As UInteger, ' DWORD
hTransaction As IntPtr ' HANDLE
) As IntPtr
End Function' lpFileName : LPCWSTR
' fInfoLevelId : FINDEX_INFO_LEVELS
' lpFindFileData : void* out
' fSearchOp : FINDEX_SEARCH_OPS
' lpSearchFilter : void* optional
' dwAdditionalFlags : DWORD
' hTransaction : HANDLE
Declare PtrSafe Function FindFirstFileTransactedW Lib "kernel32" ( _
ByVal lpFileName As LongPtr, _
ByVal fInfoLevelId As Long, _
ByVal lpFindFileData As LongPtr, _
ByVal fSearchOp As Long, _
ByVal lpSearchFilter As LongPtr, _
ByVal dwAdditionalFlags As Long, _
ByVal hTransaction As LongPtr) As LongPtr
' Unicode(W): 文字列は ByVal As LongPtr とし StrPtr(unicodeStr) を渡す
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
FindFirstFileTransactedW = ctypes.windll.kernel32.FindFirstFileTransactedW
FindFirstFileTransactedW.restype = ctypes.c_void_p
FindFirstFileTransactedW.argtypes = [
wintypes.LPCWSTR, # lpFileName : LPCWSTR
ctypes.c_int, # fInfoLevelId : FINDEX_INFO_LEVELS
ctypes.POINTER(None), # lpFindFileData : void* out
ctypes.c_int, # fSearchOp : FINDEX_SEARCH_OPS
ctypes.POINTER(None), # lpSearchFilter : void* optional
wintypes.DWORD, # dwAdditionalFlags : DWORD
wintypes.HANDLE, # hTransaction : HANDLE
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('KERNEL32.dll')
FindFirstFileTransactedW = Fiddle::Function.new(
lib['FindFirstFileTransactedW'],
[
Fiddle::TYPE_VOIDP, # lpFileName : LPCWSTR
Fiddle::TYPE_INT, # fInfoLevelId : FINDEX_INFO_LEVELS
Fiddle::TYPE_VOIDP, # lpFindFileData : void* out
Fiddle::TYPE_INT, # fSearchOp : FINDEX_SEARCH_OPS
Fiddle::TYPE_VOIDP, # lpSearchFilter : void* optional
-Fiddle::TYPE_INT, # dwAdditionalFlags : DWORD
Fiddle::TYPE_VOIDP, # hTransaction : HANDLE
],
Fiddle::TYPE_VOIDP)
# Wide strings: pass str.encode("UTF-16LE") + "\x00\x00"#[link(name = "kernel32")]
extern "system" {
fn FindFirstFileTransactedW(
lpFileName: *const u16, // LPCWSTR
fInfoLevelId: i32, // FINDEX_INFO_LEVELS
lpFindFileData: *mut (), // void* out
fSearchOp: i32, // FINDEX_SEARCH_OPS
lpSearchFilter: *mut (), // void* optional
dwAdditionalFlags: u32, // DWORD
hTransaction: *mut core::ffi::c_void // HANDLE
) -> *mut core::ffi::c_void;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("KERNEL32.dll", CharSet = CharSet.Unicode, SetLastError = true)]
public static extern IntPtr FindFirstFileTransactedW([MarshalAs(UnmanagedType.LPWStr)] string lpFileName, int fInfoLevelId, IntPtr lpFindFileData, int fSearchOp, IntPtr lpSearchFilter, uint dwAdditionalFlags, IntPtr hTransaction);
"@
$api = Add-Type -MemberDefinition $sig -Name 'KERNEL32_FindFirstFileTransactedW' -Namespace Win32 -PassThru
# $api::FindFirstFileTransactedW(lpFileName, fInfoLevelId, lpFindFileData, fSearchOp, lpSearchFilter, dwAdditionalFlags, hTransaction)#uselib "KERNEL32.dll"
#func global FindFirstFileTransactedW "FindFirstFileTransactedW" wptr, wptr, wptr, wptr, wptr, wptr, wptr
; FindFirstFileTransactedW lpFileName, fInfoLevelId, lpFindFileData, fSearchOp, lpSearchFilter, dwAdditionalFlags, hTransaction ; 戻り値は stat
; lpFileName : LPCWSTR -> "wptr"
; fInfoLevelId : FINDEX_INFO_LEVELS -> "wptr"
; lpFindFileData : void* out -> "wptr"
; fSearchOp : FINDEX_SEARCH_OPS -> "wptr"
; lpSearchFilter : void* optional -> "wptr"
; dwAdditionalFlags : DWORD -> "wptr"
; hTransaction : HANDLE -> "wptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。#uselib "KERNEL32.dll"
#cfunc global FindFirstFileTransactedW "FindFirstFileTransactedW" wstr, int, sptr, int, sptr, int, sptr
; res = FindFirstFileTransactedW(lpFileName, fInfoLevelId, lpFindFileData, fSearchOp, lpSearchFilter, dwAdditionalFlags, hTransaction)
; lpFileName : LPCWSTR -> "wstr"
; fInfoLevelId : FINDEX_INFO_LEVELS -> "int"
; lpFindFileData : void* out -> "sptr"
; fSearchOp : FINDEX_SEARCH_OPS -> "int"
; lpSearchFilter : void* optional -> "sptr"
; dwAdditionalFlags : DWORD -> "int"
; hTransaction : HANDLE -> "sptr"; HANDLE FindFirstFileTransactedW(LPCWSTR lpFileName, FINDEX_INFO_LEVELS fInfoLevelId, void* lpFindFileData, FINDEX_SEARCH_OPS fSearchOp, void* lpSearchFilter, DWORD dwAdditionalFlags, HANDLE hTransaction)
#uselib "KERNEL32.dll"
#cfunc global FindFirstFileTransactedW "FindFirstFileTransactedW" wstr, int, intptr, int, intptr, int, intptr
; res = FindFirstFileTransactedW(lpFileName, fInfoLevelId, lpFindFileData, fSearchOp, lpSearchFilter, dwAdditionalFlags, hTransaction)
; lpFileName : LPCWSTR -> "wstr"
; fInfoLevelId : FINDEX_INFO_LEVELS -> "int"
; lpFindFileData : void* out -> "intptr"
; fSearchOp : FINDEX_SEARCH_OPS -> "int"
; lpSearchFilter : void* optional -> "intptr"
; dwAdditionalFlags : DWORD -> "int"
; hTransaction : HANDLE -> "intptr"import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
kernel32 = windows.NewLazySystemDLL("KERNEL32.dll")
procFindFirstFileTransactedW = kernel32.NewProc("FindFirstFileTransactedW")
)
// lpFileName (LPCWSTR), fInfoLevelId (FINDEX_INFO_LEVELS), lpFindFileData (void* out), fSearchOp (FINDEX_SEARCH_OPS), lpSearchFilter (void* optional), dwAdditionalFlags (DWORD), hTransaction (HANDLE)
r1, _, err := procFindFirstFileTransactedW.Call(
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(lpFileName))),
uintptr(fInfoLevelId),
uintptr(lpFindFileData),
uintptr(fSearchOp),
uintptr(lpSearchFilter),
uintptr(dwAdditionalFlags),
uintptr(hTransaction),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // HANDLEfunction FindFirstFileTransactedW(
lpFileName: PWideChar; // LPCWSTR
fInfoLevelId: Integer; // FINDEX_INFO_LEVELS
lpFindFileData: Pointer; // void* out
fSearchOp: Integer; // FINDEX_SEARCH_OPS
lpSearchFilter: Pointer; // void* optional
dwAdditionalFlags: DWORD; // DWORD
hTransaction: THandle // HANDLE
): THandle; stdcall;
external 'KERNEL32.dll' name 'FindFirstFileTransactedW';result := DllCall("KERNEL32\FindFirstFileTransactedW"
, "WStr", lpFileName ; LPCWSTR
, "Int", fInfoLevelId ; FINDEX_INFO_LEVELS
, "Ptr", lpFindFileData ; void* out
, "Int", fSearchOp ; FINDEX_SEARCH_OPS
, "Ptr", lpSearchFilter ; void* optional
, "UInt", dwAdditionalFlags ; DWORD
, "Ptr", hTransaction ; HANDLE
, "Ptr") ; return: HANDLE●FindFirstFileTransactedW(lpFileName, fInfoLevelId, lpFindFileData, fSearchOp, lpSearchFilter, dwAdditionalFlags, hTransaction) = DLL("KERNEL32.dll", "void* FindFirstFileTransactedW(char*, int, void*, int, void*, dword, void*)")
# 呼び出し: FindFirstFileTransactedW(lpFileName, fInfoLevelId, lpFindFileData, fSearchOp, lpSearchFilter, dwAdditionalFlags, hTransaction)
# lpFileName : LPCWSTR -> "char*"
# fInfoLevelId : FINDEX_INFO_LEVELS -> "int"
# lpFindFileData : void* out -> "void*"
# fSearchOp : FINDEX_SEARCH_OPS -> "int"
# lpSearchFilter : void* optional -> "void*"
# dwAdditionalFlags : DWORD -> "dword"
# hTransaction : HANDLE -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
# ※-W(Unicode)関数。なでしこ1はANSIのため -A 版の利用を推奨。