SAFER_CODE_PROPERTIES_V2 Struktur (winsafer.h)

Artikel
03/04/2024

Die SAFER_CODE_PROPERTIES-Struktur enthält Codebildinformationen und Kriterien, die im Codeimage überprüft werden sollen. Ein Array von SAFER_CODE_PROPERTIES Strukturen wird an die SaferIdentifyLevel-Funktion übergeben.

SAFER_CODE_PROPERTIES_V2 ist eine Neudefinition von SAFER_CODE_PROPERTIES und eine erweiterte Version von SAFER_CODE_PROPERTIES_V1 , da sie neue Mitglieder für Windows Store-App-Pakete enthält. Vorhandene binäre Aufrufer können die Version unterscheiden, indem sie den cbSize-Member überprüfen.

Syntax

typedef struct _SAFER_CODE_PROPERTIES_V2 {
  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;
  LPCWSTR       PackageMoniker;
  LPCWSTR       PackagePublisher;
  LPCWSTR       PackageName;
  ULONG64       PackageVersion;
  BOOL          PackageIsFramework;
} SAFER_CODE_PROPERTIES_V2, *PSAFER_CODE_PROPERTIES_V2;

Member

cbSize

Die Größe dieser Struktur in Bytes. Dies wird für zukünftige und Abwärtskompatibilität verwendet.

dwCheckFlags

Die Arten von Kriterien, die bei der Bewertung dieser Struktur berücksichtigt werden. Einige Flags werden möglicherweise unbeaufsichtigt ignoriert, wenn einige oder alle der zugeordneten Strukturelemente nicht bereitgestellt werden. Wenn Sie für diesen Parameter null angeben, wird der Inhalt der gesamten Struktur ignoriert.

In der folgenden Tabelle sind die möglichen Werte aufgeführt. Diese Werte können mithilfe eines bitweisen OR-Vorgangs kombiniert werden.

Wert	Bedeutung
SAFER_CRITERIA_IMAGEPATH 0x00001	Überprüfen Sie den Codebildpfad.
SAFER_CRITERIA_IMAGEHASH 0x00004	Überprüfen Sie den Codehash.
SAFER_CRITERIA_AUTHENTICODE 0x00008	Überprüfen Sie die Authenticode-Signatur. Wenn dieser Wert verwendet wird, muss entweder das hImageFileHandle-Element oder das ImagePath-Element festgelegt werden.
SAFER_CRITERIA_URLZONE 0x00010	Überprüfen Sie die URSPRUNGS-URL.
SAFER_CRITERIA_IMAGEPATH_NT 0x01000	Überprüfen Sie den Windows NT-Imagepfad.
SAFER_CRITERIA_APPX_PACKAGE 0x00020	Suchen Sie nach einem Windows Store-App-Paket. Zur Verwendung durch Windows Store-Apps.

ImagePath

Eine Zeichenfolge, die den vollqualifizierten Pfad und den Dateinamen angibt, die für Diskriminierungsprüfungen basierend auf dem Pfad verwendet werden sollen. Der Imagepfad wird auch verwendet, um die Datei zu öffnen und zu lesen, um andere Diskriminierungskriterien zu identifizieren, die in dieser Struktur nicht angegeben sind. Dieses Element kann NULL sein. Wenn der dwCheckFlags-Member jedoch SAFER_CRITERIA_AUTHENTICODE enthält, muss entweder dieses Element oder das hImageFileHandle-Element festgelegt werden.

hImageFileHandle

Ein Dateihandle für ein Codeimage mit mindestens GENERIC_READ Zugriff. Das Handle wird verwendet, anstatt die Datei explizit erneut zu öffnen, um Diskriminierungskriterien zu berechnen, die in dieser Struktur nicht angegeben sind. Dieses Element kann NULL sein. Wenn dwCheckFlags jedoch SAFER_CRITERIA_AUTHENTICODE enthält, muss entweder dieser Member oder das ImagePath-Element festgelegt werden.

UrlZoneId

Das vordefinierte Internet Explorer Sicherheitszonen. Die folgenden Zonen werden definiert:

URLZONE_LOCAL_MACHINE
URLZONE_INTRANET
URLZONE_TRUSTED
URLZONE_INTERNET
URLZONE_UNTRUSTED

Dieses Element kann auf 0 festgelegt werden.

ImageHash[SAFER_MAX_HASH_SIZE]

Der vorab berechnete Hash des Images. Der angegebene Hash wird als gültig interpretiert, wenn sowohl der ImageSize-Member als auch der dwImageHashSize-Member nichtzero sind und das HashAlgorithm-Element einen gültigen Hashingalgorithmus von Wincrypt.h enthält.

Wenn der angegebene Hash diese Bedingungen nicht erfüllt, wird der Hash automatisch neu berechnet:

Verwenden Sie den ImageSize-Member und den pByteBlock-Member , wenn beide nichtzero sind.
Verwenden des hImageFileHandle-Members , wenn es nicht NULL ist.
Öffnen und Verwenden des ImagePath-Members , wenn er nicht NULL ist.

dwImageHashSize

Die Größe des ImageHash-Elements in Bytes.

ImageSize

Die Größe des pByteBlock-Elements in Bytes. Dieser Member wird nicht verwendet, wenn das pByteBlock-ElementNULL ist.

HashAlgorithm

Der Hashalgorithmus, der zum Erstellen des ImageHash-Elements verwendet wird.

pByteBlock

Der Speicherblock, der das Image des zu überprüfenden Codes enthält. Dieses Member ist optional. Wenn dieser Member angegeben ist, muss auch das ImageSize-Element angegeben werden.

hWndParent

Die Argumente, die für die Zertifikatüberprüfung des Authenticode-Signaturgebers verwendet werden. Diese Argumente werden an die WinVerifyTrust-Funktion übergeben und steuern die Benutzeroberfläche , die den Benutzer auffordert, anvertraute Zertifikate zu akzeptieren oder abzulehnen.

dwWVTUIChoice

Gibt den Typ der verwendeten Benutzeroberfläche an. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert	Bedeutung
WTD_UI_ALL	Zeigt die gesamte Benutzeroberfläche an.
WTD_UI_NONE	Zeigt keine Benutzeroberfläche an.
WTD_UI_NOBAD	Die Benutzeroberfläche wird nur angezeigt, wenn keine Fehler aufgetreten sind.
WTD_UI_NOGOOD	Die Benutzeroberfläche wird nur angezeigt, wenn ein Fehler auftritt.

PackageMoniker

Die Paketmoniker-Eigenschaft. Zur Verwendung durch Windows Store-Apps.