ホーム › Storage.FileSystem › FindFirstFileExW
FindFirstFileExW
関数詳細オプション付きで最初の一致ファイルを検索する。
シグネチャ
// KERNEL32.dll (Unicode / -W)
#include <windows.h>
HANDLE FindFirstFileExW(
LPCWSTR lpFileName,
FINDEX_INFO_LEVELS fInfoLevelId,
void* lpFindFileData,
FINDEX_SEARCH_OPS fSearchOp,
void* lpSearchFilter, // optional
FIND_FIRST_EX_FLAGS dwAdditionalFlags
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| lpFileName | LPCWSTR | in |
| fInfoLevelId | FINDEX_INFO_LEVELS | in |
| lpFindFileData | void* | out |
| fSearchOp | FINDEX_SEARCH_OPS | in |
| lpSearchFilter | void* | optional |
| dwAdditionalFlags | FIND_FIRST_EX_FLAGS | in |
戻り値の型: HANDLE
各言語での呼び出し定義
// KERNEL32.dll (Unicode / -W)
#include <windows.h>
HANDLE FindFirstFileExW(
LPCWSTR lpFileName,
FINDEX_INFO_LEVELS fInfoLevelId,
void* lpFindFileData,
FINDEX_SEARCH_OPS fSearchOp,
void* lpSearchFilter, // optional
FIND_FIRST_EX_FLAGS dwAdditionalFlags
);[DllImport("KERNEL32.dll", CharSet = CharSet.Unicode, SetLastError = true, ExactSpelling = true)]
static extern IntPtr FindFirstFileExW(
[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 // FIND_FIRST_EX_FLAGS
);<DllImport("KERNEL32.dll", CharSet:=CharSet.Unicode, SetLastError:=True, ExactSpelling:=True)>
Public Shared Function FindFirstFileExW(
<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 ' FIND_FIRST_EX_FLAGS
) As IntPtr
End Function' lpFileName : LPCWSTR
' fInfoLevelId : FINDEX_INFO_LEVELS
' lpFindFileData : void* out
' fSearchOp : FINDEX_SEARCH_OPS
' lpSearchFilter : void* optional
' dwAdditionalFlags : FIND_FIRST_EX_FLAGS
Declare PtrSafe Function FindFirstFileExW 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) 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
FindFirstFileExW = ctypes.windll.kernel32.FindFirstFileExW
FindFirstFileExW.restype = ctypes.c_void_p
FindFirstFileExW.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 : FIND_FIRST_EX_FLAGS
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('KERNEL32.dll')
FindFirstFileExW = Fiddle::Function.new(
lib['FindFirstFileExW'],
[
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 : FIND_FIRST_EX_FLAGS
],
Fiddle::TYPE_VOIDP)
# Wide strings: pass str.encode("UTF-16LE") + "\x00\x00"#[link(name = "kernel32")]
extern "system" {
fn FindFirstFileExW(
lpFileName: *const u16, // LPCWSTR
fInfoLevelId: i32, // FINDEX_INFO_LEVELS
lpFindFileData: *mut (), // void* out
fSearchOp: i32, // FINDEX_SEARCH_OPS
lpSearchFilter: *mut (), // void* optional
dwAdditionalFlags: u32 // FIND_FIRST_EX_FLAGS
) -> *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 FindFirstFileExW([MarshalAs(UnmanagedType.LPWStr)] string lpFileName, int fInfoLevelId, IntPtr lpFindFileData, int fSearchOp, IntPtr lpSearchFilter, uint dwAdditionalFlags);
"@
$api = Add-Type -MemberDefinition $sig -Name 'KERNEL32_FindFirstFileExW' -Namespace Win32 -PassThru
# $api::FindFirstFileExW(lpFileName, fInfoLevelId, lpFindFileData, fSearchOp, lpSearchFilter, dwAdditionalFlags)#uselib "KERNEL32.dll"
#func global FindFirstFileExW "FindFirstFileExW" wptr, wptr, wptr, wptr, wptr, wptr
; FindFirstFileExW lpFileName, fInfoLevelId, lpFindFileData, fSearchOp, lpSearchFilter, dwAdditionalFlags ; 戻り値は stat
; lpFileName : LPCWSTR -> "wptr"
; fInfoLevelId : FINDEX_INFO_LEVELS -> "wptr"
; lpFindFileData : void* out -> "wptr"
; fSearchOp : FINDEX_SEARCH_OPS -> "wptr"
; lpSearchFilter : void* optional -> "wptr"
; dwAdditionalFlags : FIND_FIRST_EX_FLAGS -> "wptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。#uselib "KERNEL32.dll"
#cfunc global FindFirstFileExW "FindFirstFileExW" wstr, int, sptr, int, sptr, int
; res = FindFirstFileExW(lpFileName, fInfoLevelId, lpFindFileData, fSearchOp, lpSearchFilter, dwAdditionalFlags)
; lpFileName : LPCWSTR -> "wstr"
; fInfoLevelId : FINDEX_INFO_LEVELS -> "int"
; lpFindFileData : void* out -> "sptr"
; fSearchOp : FINDEX_SEARCH_OPS -> "int"
; lpSearchFilter : void* optional -> "sptr"
; dwAdditionalFlags : FIND_FIRST_EX_FLAGS -> "int"; HANDLE FindFirstFileExW(LPCWSTR lpFileName, FINDEX_INFO_LEVELS fInfoLevelId, void* lpFindFileData, FINDEX_SEARCH_OPS fSearchOp, void* lpSearchFilter, FIND_FIRST_EX_FLAGS dwAdditionalFlags)
#uselib "KERNEL32.dll"
#cfunc global FindFirstFileExW "FindFirstFileExW" wstr, int, intptr, int, intptr, int
; res = FindFirstFileExW(lpFileName, fInfoLevelId, lpFindFileData, fSearchOp, lpSearchFilter, dwAdditionalFlags)
; lpFileName : LPCWSTR -> "wstr"
; fInfoLevelId : FINDEX_INFO_LEVELS -> "int"
; lpFindFileData : void* out -> "intptr"
; fSearchOp : FINDEX_SEARCH_OPS -> "int"
; lpSearchFilter : void* optional -> "intptr"
; dwAdditionalFlags : FIND_FIRST_EX_FLAGS -> "int"import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
kernel32 = windows.NewLazySystemDLL("KERNEL32.dll")
procFindFirstFileExW = kernel32.NewProc("FindFirstFileExW")
)
// lpFileName (LPCWSTR), fInfoLevelId (FINDEX_INFO_LEVELS), lpFindFileData (void* out), fSearchOp (FINDEX_SEARCH_OPS), lpSearchFilter (void* optional), dwAdditionalFlags (FIND_FIRST_EX_FLAGS)
r1, _, err := procFindFirstFileExW.Call(
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(lpFileName))),
uintptr(fInfoLevelId),
uintptr(lpFindFileData),
uintptr(fSearchOp),
uintptr(lpSearchFilter),
uintptr(dwAdditionalFlags),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // HANDLEfunction FindFirstFileExW(
lpFileName: PWideChar; // LPCWSTR
fInfoLevelId: Integer; // FINDEX_INFO_LEVELS
lpFindFileData: Pointer; // void* out
fSearchOp: Integer; // FINDEX_SEARCH_OPS
lpSearchFilter: Pointer; // void* optional
dwAdditionalFlags: DWORD // FIND_FIRST_EX_FLAGS
): THandle; stdcall;
external 'KERNEL32.dll' name 'FindFirstFileExW';result := DllCall("KERNEL32\FindFirstFileExW"
, "WStr", lpFileName ; LPCWSTR
, "Int", fInfoLevelId ; FINDEX_INFO_LEVELS
, "Ptr", lpFindFileData ; void* out
, "Int", fSearchOp ; FINDEX_SEARCH_OPS
, "Ptr", lpSearchFilter ; void* optional
, "UInt", dwAdditionalFlags ; FIND_FIRST_EX_FLAGS
, "Ptr") ; return: HANDLE●FindFirstFileExW(lpFileName, fInfoLevelId, lpFindFileData, fSearchOp, lpSearchFilter, dwAdditionalFlags) = DLL("KERNEL32.dll", "void* FindFirstFileExW(char*, int, void*, int, void*, dword)")
# 呼び出し: FindFirstFileExW(lpFileName, fInfoLevelId, lpFindFileData, fSearchOp, lpSearchFilter, dwAdditionalFlags)
# lpFileName : LPCWSTR -> "char*"
# fInfoLevelId : FINDEX_INFO_LEVELS -> "int"
# lpFindFileData : void* out -> "void*"
# fSearchOp : FINDEX_SEARCH_OPS -> "int"
# lpSearchFilter : void* optional -> "void*"
# dwAdditionalFlags : FIND_FIRST_EX_FLAGS -> "dword"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
# ※-W(Unicode)関数。なでしこ1はANSIのため -A 版の利用を推奨。