Win32 API 日本語リファレンス
ホームSecurity.AppLocker › SAFER_PATHNAME_IDENTIFICATION

SAFER_PATHNAME_IDENTIFICATION

構造体
サイズx64: 560 バイト / x86: 552 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
headerSAFER_IDENTIFICATION_HEADER32+0+0識別レコード共通ヘッダー。種別やGUID等を含む。
DescriptionWCHAR512+32+32このパスルールの説明文(WCHAR配列)。
ImageNameLPWSTR8/4+544+544規則の対象となるパスまたはファイル名パターン文字列。ワイルドカード可。
dwSaferFlagsDWORD4+552+548SAFER動作を制御するフラグ。予約またはオプション指定に用いる。

各言語での定義

#include <windows.h>

// FILETIME  (x64 8 / x86 8 バイト)
typedef struct FILETIME {
    DWORD dwLowDateTime;
    DWORD dwHighDateTime;
} FILETIME;

// SAFER_IDENTIFICATION_HEADER  (x64 32 / x86 32 バイト)
typedef struct SAFER_IDENTIFICATION_HEADER {
    SAFER_IDENTIFICATION_TYPES dwIdentificationType;
    DWORD cbStructSize;
    GUID IdentificationGuid;
    FILETIME lastModified;
} SAFER_IDENTIFICATION_HEADER;

// SAFER_PATHNAME_IDENTIFICATION  (x64 560 / x86 552 バイト)
typedef struct SAFER_PATHNAME_IDENTIFICATION {
    SAFER_IDENTIFICATION_HEADER header;
    WCHAR Description[256];
    LPWSTR ImageName;
    DWORD dwSaferFlags;
} SAFER_PATHNAME_IDENTIFICATION;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FILETIME
{
    public uint dwLowDateTime;
    public uint dwHighDateTime;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SAFER_IDENTIFICATION_HEADER
{
    public int dwIdentificationType;
    public uint cbStructSize;
    public Guid IdentificationGuid;
    public FILETIME lastModified;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SAFER_PATHNAME_IDENTIFICATION
{
    public SAFER_IDENTIFICATION_HEADER header;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 256)] public string Description;
    public IntPtr ImageName;
    public uint dwSaferFlags;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FILETIME
    Public dwLowDateTime As UInteger
    Public dwHighDateTime As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SAFER_IDENTIFICATION_HEADER
    Public dwIdentificationType As Integer
    Public cbStructSize As UInteger
    Public IdentificationGuid As Guid
    Public lastModified As FILETIME
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SAFER_PATHNAME_IDENTIFICATION
    Public header As SAFER_IDENTIFICATION_HEADER
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=256)> Public Description As String
    Public ImageName As IntPtr
    Public dwSaferFlags As UInteger
End Structure
import ctypes
from ctypes import wintypes

class FILETIME(ctypes.Structure):
    _fields_ = [
        ("dwLowDateTime", wintypes.DWORD),
        ("dwHighDateTime", wintypes.DWORD),
    ]

class SAFER_IDENTIFICATION_HEADER(ctypes.Structure):
    _fields_ = [
        ("dwIdentificationType", ctypes.c_int),
        ("cbStructSize", wintypes.DWORD),
        ("IdentificationGuid", GUID),
        ("lastModified", FILETIME),
    ]

class SAFER_PATHNAME_IDENTIFICATION(ctypes.Structure):
    _fields_ = [
        ("header", SAFER_IDENTIFICATION_HEADER),
        ("Description", ctypes.c_wchar * 256),
        ("ImageName", ctypes.c_void_p),
        ("dwSaferFlags", wintypes.DWORD),
    ]
#[repr(C)]
pub struct FILETIME {
    pub dwLowDateTime: u32,
    pub dwHighDateTime: u32,
}

#[repr(C)]
pub struct SAFER_IDENTIFICATION_HEADER {
    pub dwIdentificationType: i32,
    pub cbStructSize: u32,
    pub IdentificationGuid: GUID,
    pub lastModified: FILETIME,
}

#[repr(C)]
pub struct SAFER_PATHNAME_IDENTIFICATION {
    pub header: SAFER_IDENTIFICATION_HEADER,
    pub Description: [u16; 256],
    pub ImageName: *mut core::ffi::c_void,
    pub dwSaferFlags: u32,
}
import "golang.org/x/sys/windows"

type FILETIME struct {
	dwLowDateTime uint32
	dwHighDateTime uint32
}

type SAFER_IDENTIFICATION_HEADER struct {
	dwIdentificationType int32
	cbStructSize uint32
	IdentificationGuid windows.GUID
	lastModified FILETIME
}

type SAFER_PATHNAME_IDENTIFICATION struct {
	header SAFER_IDENTIFICATION_HEADER
	Description [256]uint16
	ImageName uintptr
	dwSaferFlags uint32
}
type
  FILETIME = record
    dwLowDateTime: DWORD;
    dwHighDateTime: DWORD;
  end;

  SAFER_IDENTIFICATION_HEADER = record
    dwIdentificationType: Integer;
    cbStructSize: DWORD;
    IdentificationGuid: TGUID;
    lastModified: FILETIME;
  end;

  SAFER_PATHNAME_IDENTIFICATION = record
    header: SAFER_IDENTIFICATION_HEADER;
    Description: array[0..255] of WideChar;
    ImageName: Pointer;
    dwSaferFlags: DWORD;
  end;
const FILETIME = extern struct {
    dwLowDateTime: u32,
    dwHighDateTime: u32,
};

const SAFER_IDENTIFICATION_HEADER = extern struct {
    dwIdentificationType: i32,
    cbStructSize: u32,
    IdentificationGuid: GUID,
    lastModified: FILETIME,
};

const SAFER_PATHNAME_IDENTIFICATION = extern struct {
    header: SAFER_IDENTIFICATION_HEADER,
    Description: [256]u16,
    ImageName: ?*anyopaque,
    dwSaferFlags: u32,
};
type
  FILETIME {.bycopy.} = object
    dwLowDateTime: uint32
    dwHighDateTime: uint32

  SAFER_IDENTIFICATION_HEADER {.bycopy.} = object
    dwIdentificationType: int32
    cbStructSize: uint32
    IdentificationGuid: GUID
    lastModified: FILETIME

  SAFER_PATHNAME_IDENTIFICATION {.bycopy.} = object
    header: SAFER_IDENTIFICATION_HEADER
    Description: array[256, uint16]
    ImageName: pointer
    dwSaferFlags: uint32
struct FILETIME
{
    uint dwLowDateTime;
    uint dwHighDateTime;
}

struct SAFER_IDENTIFICATION_HEADER
{
    int dwIdentificationType;
    uint cbStructSize;
    GUID IdentificationGuid;
    FILETIME lastModified;
}

struct SAFER_PATHNAME_IDENTIFICATION
{
    SAFER_IDENTIFICATION_HEADER header;
    wchar[256] Description;
    void* ImageName;
    uint dwSaferFlags;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; SAFER_PATHNAME_IDENTIFICATION サイズ: 552 バイト(x86)
dim st, 138    ; 4byte整数×138(構造体サイズ 552 / 4 切り上げ)
; header : SAFER_IDENTIFICATION_HEADER (+0, 32byte)  varptr(st)+0 を基点に操作(32byte:入れ子/配列)
; Description : WCHAR (+32, 512byte)  varptr(st)+32 を基点に操作(512byte:入れ子/配列)
; ImageName : LPWSTR (+544, 4byte)  st.136 = 値  /  値 = st.136   (lpoke/lpeek も可)
; dwSaferFlags : DWORD (+548, 4byte)  st.137 = 値  /  値 = st.137   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SAFER_PATHNAME_IDENTIFICATION サイズ: 560 バイト(x64)
dim st, 140    ; 4byte整数×140(構造体サイズ 560 / 4 切り上げ)
; header : SAFER_IDENTIFICATION_HEADER (+0, 32byte)  varptr(st)+0 を基点に操作(32byte:入れ子/配列)
; Description : WCHAR (+32, 512byte)  varptr(st)+32 を基点に操作(512byte:入れ子/配列)
; ImageName : LPWSTR (+544, 8byte)  qpoke st,544,値 / qpeek(st,544)  ※IronHSPのみ。3.7/3.8は lpoke st,544,下位 : lpoke st,548,上位
; dwSaferFlags : DWORD (+552, 4byte)  st.138 = 値  /  値 = st.138   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
    #field int Data1
    #field short Data2
    #field short Data3
    #field byte Data4 8
#endstruct

#defstruct global FILETIME
    #field int dwLowDateTime
    #field int dwHighDateTime
#endstruct

#defstruct global SAFER_IDENTIFICATION_HEADER
    #field int dwIdentificationType
    #field int cbStructSize
    #field GUID IdentificationGuid
    #field FILETIME lastModified
#endstruct

#defstruct global SAFER_PATHNAME_IDENTIFICATION
    #field SAFER_IDENTIFICATION_HEADER header
    #field wchar Description 256
    #field intptr ImageName
    #field int dwSaferFlags
#endstruct

stdim st, SAFER_PATHNAME_IDENTIFICATION        ; NSTRUCT 変数を確保
st->dwSaferFlags = 100
mes "dwSaferFlags=" + st->dwSaferFlags