ホーム › Security.NetworkAccessProtection › FailureCategoryMapping
FailureCategoryMapping
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| mappingCompliance | BOOL | 20 | +0 | +0 | 各 FailureCategory のコンプライアンス状態を格納する BOOLs の配列です。TRUE はそのカテゴリが準拠していることを示し、FALSE は非準拠であることを示します。 Note mappingCompliance の長さは failureCategoryCount によって定義されます。
|
公式ドキュメント
Note Network Access Protection プラットフォームは Windows 10 以降では利用できません
解説(Remarks)
システムで障害 (コンポーネントの障害や通信障害など) が発生した場合、SHV はコンプライアンスの判定を行う代わりに、SoHResponse 内で sohAttributeTypeFailureCategory 型の type-length-value (TLV) オブジェクトを返すことがあります。すると NAP システムは、TLV オブジェクトによって返された FailureCategory 型を、FailureCategoryMapping 構造体内で次のように準拠または非準拠に対応付けます。
- mappingCompliance[0] = failureCategoryOther に対する対応付け
- mappingCompliance[1] = failureCategoryClientComponent に対する対応付け
- mappingCompliance[2] = failureCategoryClientCommunication に対する対応付け
- mappingCompliance[3] = failureCategoryServerComponent に対する対応付け
- mappingCompliance[4] = failureCategoryServerCommunication に対する対応付け
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// FailureCategoryMapping (x64 20 / x86 20 バイト)
typedef struct FailureCategoryMapping {
BOOL mappingCompliance[5];
} FailureCategoryMapping;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FailureCategoryMapping
{
[MarshalAs(UnmanagedType.ByValArray, ArraySubType = UnmanagedType.Bool, SizeConst = 5)] public bool[] mappingCompliance;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FailureCategoryMapping
<MarshalAs(UnmanagedType.ByValArray, ArraySubType:=UnmanagedType.Bool, SizeConst:=5)> Public mappingCompliance() As Boolean
End Structureimport ctypes
from ctypes import wintypes
class FailureCategoryMapping(ctypes.Structure):
_fields_ = [
("mappingCompliance", wintypes.BOOL * 5),
]#[repr(C)]
pub struct FailureCategoryMapping {
pub mappingCompliance: [i32; 5],
}import "golang.org/x/sys/windows"
type FailureCategoryMapping struct {
mappingCompliance [5]int32
}type
FailureCategoryMapping = record
mappingCompliance: array[0..4] of BOOL;
end;const FailureCategoryMapping = extern struct {
mappingCompliance: [5]i32,
};type
FailureCategoryMapping {.bycopy.} = object
mappingCompliance: array[5, int32]struct FailureCategoryMapping
{
int[5] mappingCompliance;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; FailureCategoryMapping サイズ: 20 バイト(x64)
dim st, 5 ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; mappingCompliance : BOOL (+0, 20byte) varptr(st)+0 を基点に操作(20byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global FailureCategoryMapping
#field bool mappingCompliance 5
#endstruct
stdim st, FailureCategoryMapping ; NSTRUCT 変数を確保