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

SAFER_HASH_IDENTIFICATION

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

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

フィールド

フィールドサイズx64x86説明
headerSAFER_IDENTIFICATION_HEADER32+0+0識別レコード共通ヘッダー。種別やGUID等を含む。
DescriptionWCHAR512+32+32このハッシュルールの説明文(WCHAR配列)。
FriendlyNameWCHAR512+544+544規則に付けられた表示用の分かりやすい名前(WCHAR配列)。
HashSizeDWORD4+1056+1056ImageHashの有効バイト数を示す。
ImageHashBYTE64+1060+1060対象ファイルのハッシュ値を格納するバイト配列。
HashAlgorithmALG_ID4+1124+1124ハッシュ計算に用いたアルゴリズム識別子(ALG_ID)。
ImageSizeLONGLONG8+1128+1128対象ファイルのサイズをバイト単位で示す。64ビット長。
dwSaferFlagsDWORD4+1136+1136SAFER動作を制御するフラグ。予約またはオプション指定に用いる。

各言語での定義

#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_HASH_IDENTIFICATION  (x64 1144 / x86 1144 バイト)
typedef struct SAFER_HASH_IDENTIFICATION {
    SAFER_IDENTIFICATION_HEADER header;
    WCHAR Description[256];
    WCHAR FriendlyName[256];
    DWORD HashSize;
    BYTE ImageHash[64];
    ALG_ID HashAlgorithm;
    LONGLONG ImageSize;
    DWORD dwSaferFlags;
} SAFER_HASH_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_HASH_IDENTIFICATION
{
    public SAFER_IDENTIFICATION_HEADER header;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 256)] public string Description;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 256)] public string FriendlyName;
    public uint HashSize;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 64)] public byte[] ImageHash;
    public uint HashAlgorithm;
    public long ImageSize;
    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_HASH_IDENTIFICATION
    Public header As SAFER_IDENTIFICATION_HEADER
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=256)> Public Description As String
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=256)> Public FriendlyName As String
    Public HashSize As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=64)> Public ImageHash() As Byte
    Public HashAlgorithm As UInteger
    Public ImageSize As Long
    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_HASH_IDENTIFICATION(ctypes.Structure):
    _fields_ = [
        ("header", SAFER_IDENTIFICATION_HEADER),
        ("Description", ctypes.c_wchar * 256),
        ("FriendlyName", ctypes.c_wchar * 256),
        ("HashSize", wintypes.DWORD),
        ("ImageHash", ctypes.c_ubyte * 64),
        ("HashAlgorithm", wintypes.DWORD),
        ("ImageSize", ctypes.c_longlong),
        ("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_HASH_IDENTIFICATION {
    pub header: SAFER_IDENTIFICATION_HEADER,
    pub Description: [u16; 256],
    pub FriendlyName: [u16; 256],
    pub HashSize: u32,
    pub ImageHash: [u8; 64],
    pub HashAlgorithm: u32,
    pub ImageSize: i64,
    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_HASH_IDENTIFICATION struct {
	header SAFER_IDENTIFICATION_HEADER
	Description [256]uint16
	FriendlyName [256]uint16
	HashSize uint32
	ImageHash [64]byte
	HashAlgorithm uint32
	ImageSize int64
	dwSaferFlags uint32
}
type
  FILETIME = record
    dwLowDateTime: DWORD;
    dwHighDateTime: DWORD;
  end;

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

  SAFER_HASH_IDENTIFICATION = record
    header: SAFER_IDENTIFICATION_HEADER;
    Description: array[0..255] of WideChar;
    FriendlyName: array[0..255] of WideChar;
    HashSize: DWORD;
    ImageHash: array[0..63] of Byte;
    HashAlgorithm: DWORD;
    ImageSize: Int64;
    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_HASH_IDENTIFICATION = extern struct {
    header: SAFER_IDENTIFICATION_HEADER,
    Description: [256]u16,
    FriendlyName: [256]u16,
    HashSize: u32,
    ImageHash: [64]u8,
    HashAlgorithm: u32,
    ImageSize: i64,
    dwSaferFlags: u32,
};
type
  FILETIME {.bycopy.} = object
    dwLowDateTime: uint32
    dwHighDateTime: uint32

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

  SAFER_HASH_IDENTIFICATION {.bycopy.} = object
    header: SAFER_IDENTIFICATION_HEADER
    Description: array[256, uint16]
    FriendlyName: array[256, uint16]
    HashSize: uint32
    ImageHash: array[64, uint8]
    HashAlgorithm: uint32
    ImageSize: int64
    dwSaferFlags: uint32
struct FILETIME
{
    uint dwLowDateTime;
    uint dwHighDateTime;
}

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

struct SAFER_HASH_IDENTIFICATION
{
    SAFER_IDENTIFICATION_HEADER header;
    wchar[256] Description;
    wchar[256] FriendlyName;
    uint HashSize;
    ubyte[64] ImageHash;
    uint HashAlgorithm;
    long ImageSize;
    uint dwSaferFlags;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SAFER_HASH_IDENTIFICATION サイズ: 1144 バイト(x64)
dim st, 286    ; 4byte整数×286(構造体サイズ 1144 / 4 切り上げ)
; header : SAFER_IDENTIFICATION_HEADER (+0, 32byte)  varptr(st)+0 を基点に操作(32byte:入れ子/配列)
; Description : WCHAR (+32, 512byte)  varptr(st)+32 を基点に操作(512byte:入れ子/配列)
; FriendlyName : WCHAR (+544, 512byte)  varptr(st)+544 を基点に操作(512byte:入れ子/配列)
; HashSize : DWORD (+1056, 4byte)  st.264 = 値  /  値 = st.264   (lpoke/lpeek も可)
; ImageHash : BYTE (+1060, 64byte)  varptr(st)+1060 を基点に操作(64byte:入れ子/配列)
; HashAlgorithm : ALG_ID (+1124, 4byte)  st.281 = 値  /  値 = st.281   (lpoke/lpeek も可)
; ImageSize : LONGLONG (+1128, 8byte)  qpoke st,1128,値 / qpeek(st,1128)  ※IronHSPのみ。3.7/3.8は lpoke st,1128,下位 : lpoke st,1132,上位
; dwSaferFlags : DWORD (+1136, 4byte)  st.284 = 値  /  値 = st.284   (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_HASH_IDENTIFICATION
    #field SAFER_IDENTIFICATION_HEADER header
    #field wchar Description 256
    #field wchar FriendlyName 256
    #field int HashSize
    #field byte ImageHash 64
    #field int HashAlgorithm
    #field int64 ImageSize
    #field int dwSaferFlags
#endstruct

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