SAFER_CODE_PROPERTIES_V1 構造体 (winsafer.h)

[アーティクル]
08/27/2023

SAFER_CODE_PROPERTIES_V1構造体には、コードイメージの情報と、コードイメージで確認する条件が含まれています。 SAFER_CODE_PROPERTIES_V1構造体の配列が SaferIdentifyLevel 関数に渡されます。

SAFER_CODE_PROPERTIES_V1には、Windows ストアアプリパッケージの新しいメンバーは含まれません。既存のバイナリ呼び出し元は、 cbSize メンバーを確認することで、どのバージョンを区別できます。

構文

typedef struct _SAFER_CODE_PROPERTIES_V1 {
  DWORD         cbSize;
  DWORD         dwCheckFlags;
  LPCWSTR       ImagePath;
  HANDLE        hImageFileHandle;
  DWORD         UrlZoneId;
  BYTE          ImageHash[SAFER_MAX_HASH_SIZE];
  DWORD         dwImageHashSize;
  LARGE_INTEGER ImageSize;
  ALG_ID        HashAlgorithm;
  LPBYTE        pByteBlock;
  HWND          hWndParent;
  DWORD         dwWVTUIChoice;
} SAFER_CODE_PROPERTIES_V1, *PSAFER_CODE_PROPERTIES_V1;

メンバー

cbSize

この構造体のサイズ (バイト単位)。これは、将来および下位互換性のために使用されます。

dwCheckFlags

この構造を評価するときに考慮される条件の種類。関連付けられている構造体要素の一部またはすべてが指定されていない場合、一部のフラグは無視されることがあります。このパラメーターに 0 を指定すると、構造体の内容全体が無視されます。

次の表に、それぞれの値を示します。これらの値は、ビットごとの OR 演算を使用して結合できます。

値	意味
SAFER_CRITERIA_IMAGEPATH 0x00001	コードイメージのパスを確認します。
SAFER_CRITERIA_IMAGEHASH 0x00004	コードハッシュを確認します。
SAFER_CRITERIA_AUTHENTICODE 0x00008	Authenticode 署名を確認します。この値を使用する場合は、 hImageFileHandle メンバーまたは ImagePath メンバーを設定する必要があります。
SAFER_CRITERIA_URLZONE 0x00010	配信元の URL を確認します。
SAFER_CRITERIA_IMAGEPATH_NT 0x01000	Windows NTイメージパスを確認します。

ImagePath

パスに基づく判別チェックに使用する完全修飾パスとファイル名を指定する文字列。イメージパスは、ファイルを開いて読み取るためにも使用され、この構造で指定されていない他の判別基準を識別します。このメンバーは NULL にすることができます。ただし、 dwCheckFlags メンバーに SAFER_CRITERIA_AUTHENTICODEが含まれている場合は、このメンバーまたは hImageFileHandle メンバーを設定する必要があります。

hImageFileHandle

少なくともGENERIC_READアクセス権を持つコードイメージへのファイルハンドル。この構造体で指定されていない判別基準を計算するためにファイルを明示的に再度開く代わりに、ハンドルが使用されます。このメンバーは NULL にすることができます。ただし、 dwCheckFlags に SAFER_CRITERIA_AUTHENTICODEが含まれている場合は、このメンバーまたは ImagePath メンバーを設定する必要があります。

UrlZoneId

事前に定義されたインターネットエクスプローラーセキュリティゾーン。次のゾーンが定義されています。

URLZONE_LOCAL_MACHINE
URLZONE_INTRANET
URLZONE_TRUSTED
URLZONE_INTERNET
URLZONE_UNTRUSTED

このメンバーは 0 に設定できます。

ImageHash[SAFER_MAX_HASH_SIZE]

画像の事前計算済みハッシュ。 ImageSize メンバーと dwImageHashSize メンバーの両方が 0 以外で、HashAlgorithm メンバーに Wincrypt.h からの有効なハッシュアルゴリズムが含まれている場合、指定されたハッシュは有効と解釈されます。

指定されたハッシュがこれらの条件を満たさなければ、ハッシュは次の方法で自動的に再計算されます。

ImageSize メンバーと pByteBlock メンバーの使用 (両方が 0 以外の場合)。
hImageFileHandle メンバーが NULL でない場合は、そのメンバーを使用します。
ImagePath メンバーを開いて使用します (NULL でない場合)。

dwImageHashSize

ImageHash メンバーのサイズ (バイト単位)。

ImageSize

pByteBlock メンバーのサイズ (バイト単位)。 pByteBlock メンバーが NULL の場合、このメンバーは使用されません。

HashAlgorithm

ImageHash メンバーの作成に使用されるハッシュアルゴリズム。

pByteBlock

チェック対象のコードのイメージを含むメモリブロック。このメンバーは省略可能です。このメンバーを指定する場合は、 ImageSize メンバーも指定する必要があります。

hWndParent

Authenticode 署名者証明書の検証に使用される引数。これらの引数は WinVerifyTrust 関数に渡され、ユーザーに、信頼された証明書の受け入れまたは拒否を求める UI を制御します。

dwWVTUIChoice

使用される UI の種類を示します。次の表に、それぞれの値を示します。

[値]	意味
WTD_UI_ALL	すべての UI を表示します。
WTD_UI_NONE	UI を表示しません。
WTD_UI_NOBAD	エラーがない場合にのみ UI を表示します。
WTD_UI_NOGOOD	エラーが発生した場合にのみ UI を表示します。

注釈

SAFER_CODE_PROPERTIES 再定義され、Windows ストアアプリで構造体を使用できるようにする追加のメンバーが含まれています。 cbSize メンバーで、構造体の適切なサイズと、SAFER_CODE_PROPERTIES構造体とSAFER_CODE_PROPERTIES_V1構造体のどちらを使用する必要があるかを確認します。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
Header	winsafer.h

次の方法で共有

SAFER_CODE_PROPERTIES_V1 構造体 (winsafer.h)

構文

メンバー

注釈

要件

フィードバック

その他のリソース