FixupInfo
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| state | FixupState | 4 | +0 | +0 | SHA の修復状態を定義する FixupState 値です。 |
| percentage | BYTE | 1 | +4 | +4 | 完了した修復の割合を格納する Percentage データ型です。state が FixupStateInProgress と等しい場合、このメンバーは 0 から 100 までの 0 以外の値になります。それ以外の場合は 0 です。 メモ SHA が割合をサポートしていない場合、この値は 0 (SHA の更新がまだ開始されていないことを示します)、または 101 (SHA が更新処理中であることを示します) のいずれかになります。
|
| resultCodes | ResultCodes | 16/8 | +8 | +8 | GetFixupInfo の呼び出しで NAP エージェントに返される、SHA が定義した HRESULT 値を格納する ResultCodes 構造体です。 |
| fixupMsgId | DWORD | 4 | +24 | +16 | 修復状態構造体の SHA 定義リソース ID を格納する MessageID 値です。 |
公式ドキュメント
解説(Remarks)
SHA の修復処理が更新中の割合の報告をサポートしている場合、percentage は現在の進行状況を整数の割合値として伝えるために使用されます。修復の更新が完了したときは、percentage を 100 に設定し、state を fixupStateSuccess に設定しなければなりません。修復が完了していない場合は、percentage を 0 から 99 までの値 (両端を含む) に設定し、state を fixupStateInProgress に設定しなければなりません。
修復処理が割合値の報告をサポートしていない場合は、state が fixupStateInProgress に設定されている間、percentage を 101 に設定しなければなりません。この値は、修復処理が一般的な「更新中」の状態にあるものの、完了の度合いは不明であることを示します。修復が完了したときは、state を fixupStateSuccess に、percentage を 100 に設定しなければなりません。
SHA が修復情報を更新できない場合は、state を fixupStateCouldNotUpdate に設定しなければなりません。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// ResultCodes (x64 16 / x86 8 バイト)
typedef struct ResultCodes {
WORD count;
HRESULT* results;
} ResultCodes;
// FixupInfo (x64 32 / x86 20 バイト)
typedef struct FixupInfo {
FixupState state;
BYTE percentage;
ResultCodes resultCodes;
DWORD fixupMsgId;
} FixupInfo;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ResultCodes
{
public ushort count;
public IntPtr results;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FixupInfo
{
public int state;
public byte percentage;
public ResultCodes resultCodes;
public uint fixupMsgId;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure ResultCodes
Public count As UShort
Public results As IntPtr
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FixupInfo
Public state As Integer
Public percentage As Byte
Public resultCodes As ResultCodes
Public fixupMsgId As UInteger
End Structureimport ctypes
from ctypes import wintypes
class ResultCodes(ctypes.Structure):
_fields_ = [
("count", ctypes.c_ushort),
("results", ctypes.c_void_p),
]
class FixupInfo(ctypes.Structure):
_fields_ = [
("state", ctypes.c_int),
("percentage", ctypes.c_ubyte),
("resultCodes", ResultCodes),
("fixupMsgId", wintypes.DWORD),
]#[repr(C)]
pub struct ResultCodes {
pub count: u16,
pub results: *mut core::ffi::c_void,
}
#[repr(C)]
pub struct FixupInfo {
pub state: i32,
pub percentage: u8,
pub resultCodes: ResultCodes,
pub fixupMsgId: u32,
}import "golang.org/x/sys/windows"
type ResultCodes struct {
count uint16
results uintptr
}
type FixupInfo struct {
state int32
percentage byte
resultCodes ResultCodes
fixupMsgId uint32
}type
ResultCodes = record
count: Word;
results: Pointer;
end;
FixupInfo = record
state: Integer;
percentage: Byte;
resultCodes: ResultCodes;
fixupMsgId: DWORD;
end;const ResultCodes = extern struct {
count: u16,
results: ?*anyopaque,
};
const FixupInfo = extern struct {
state: i32,
percentage: u8,
resultCodes: ResultCodes,
fixupMsgId: u32,
};type
ResultCodes {.bycopy.} = object
count: uint16
results: pointer
FixupInfo {.bycopy.} = object
state: int32
percentage: uint8
resultCodes: ResultCodes
fixupMsgId: uint32struct ResultCodes
{
ushort count;
void* results;
}
struct FixupInfo
{
int state;
ubyte percentage;
ResultCodes resultCodes;
uint fixupMsgId;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; FixupInfo サイズ: 20 バイト(x86)
dim st, 5 ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; state : FixupState (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; percentage : BYTE (+4, 1byte) poke st,4,値 / 値 = peek(st,4)
; resultCodes : ResultCodes (+8, 8byte) varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; fixupMsgId : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; FixupInfo サイズ: 32 バイト(x64)
dim st, 8 ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; state : FixupState (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; percentage : BYTE (+4, 1byte) poke st,4,値 / 値 = peek(st,4)
; resultCodes : ResultCodes (+8, 16byte) varptr(st)+8 を基点に操作(16byte:入れ子/配列)
; fixupMsgId : DWORD (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global ResultCodes
#field short count
#field intptr results
#endstruct
#defstruct global FixupInfo
#field int state
#field byte percentage
#field ResultCodes resultCodes
#field int fixupMsgId
#endstruct
stdim st, FixupInfo ; NSTRUCT 変数を確保
st->state = 100
mes "state=" + st->state