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

FixupInfo

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

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

フィールド

フィールドサイズx64x86説明
stateFixupState4+0+0SHA の修復状態を定義する FixupState 値です。
percentageBYTE1+4+4

完了した修復の割合を格納する Percentage データ型です。stateFixupStateInProgress と等しい場合、このメンバーは 0 から 100 までの 0 以外の値になります。それ以外の場合は 0 です。

メモ SHA が割合をサポートしていない場合、この値は 0 (SHA の更新がまだ開始されていないことを示します)、または 101 (SHA が更新処理中であることを示します) のいずれかになります。
resultCodesResultCodes16/8+8+8GetFixupInfo の呼び出しで NAP エージェントに返される、SHA が定義した HRESULT 値を格納する ResultCodes 構造体です。
fixupMsgIdDWORD4+24+16修復状態構造体の SHA 定義リソース ID を格納する MessageID 値です。

公式ドキュメント

メモ ネットワーク アクセス保護プラットフォームは、Windows 10 以降では利用できません
FixupInfo 構造体は、システム正常性エージェント (SHA) の修復情報を格納します。

解説(Remarks)

SHA の修復処理が更新中の割合の報告をサポートしている場合、percentage は現在の進行状況を整数の割合値として伝えるために使用されます。修復の更新が完了したときは、percentage を 100 に設定し、statefixupStateSuccess に設定しなければなりません。修復が完了していない場合は、percentage を 0 から 99 までの値 (両端を含む) に設定し、statefixupStateInProgress に設定しなければなりません。

修復処理が割合値の報告をサポートしていない場合は、statefixupStateInProgress に設定されている間、percentage を 101 に設定しなければなりません。この値は、修復処理が一般的な「更新中」の状態にあるものの、完了の度合いは不明であることを示します。修復が完了したときは、statefixupStateSuccess に、percentage を 100 に設定しなければなりません。

SHA が修復情報を更新できない場合は、statefixupStateCouldNotUpdate に設定しなければなりません。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
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 Structure
import 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: uint32
struct 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