Condividi tramite

SAFER_CODE_PROPERTIES_V1 struttura (winsafer.h)

  • Articolo

La struttura SAFER_CODE_PROPERTIES_V1 contiene informazioni sull'immagine del codice e criteri da controllare nell'immagine del codice. Una matrice di strutture SAFER_CODE_PROPERTIES_V1 viene passata alla funzione SaferIdentifyLevel .

SAFER_CODE_PROPERTIES_V1 non include i nuovi membri per i pacchetti di app di Windows Store. I chiamanti binari esistenti possono distinguere la versione controllando il membro cbSize .

Sintassi

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;

Members

cbSize

Dimensione, in byte, della struttura. Questa operazione viene usata per la compatibilità futura e con le versioni precedenti.

dwCheckFlags

I tipi di criteri considerati durante la valutazione di questa struttura. Alcuni flag potrebbero essere ignorati in modo invisibile se alcuni o tutti gli elementi della struttura associati non vengono forniti. Se si specifica zero per questo parametro, il contenuto dell'intera struttura deve essere ignorato.

Nella tabella seguente sono illustrati i possibili valori. Questi valori possono essere combinati usando un'operazione bit per bit-OR .

Valore Significato
SAFER_CRITERIA_IMAGEPATH
0x00001
 Controllare il percorso dell'immagine del codice.
SAFER_CRITERIA_IMAGEHASH
0x00004
 Controllare l'hash del codice.
SAFER_CRITERIA_AUTHENTICODE
0x00008
 Controllare la firma Authenticode. Se questo valore viene usato, è necessario impostare il membro hImageFileHandle o il membro ImagePath .
SAFER_CRITERIA_URLZONE
0x00010
 Controllare l'URL di origine.
SAFER_CRITERIA_IMAGEPATH_NT
0x01000
 Controllare il percorso dell'immagine windows NT.

ImagePath

Stringa che specifica il percorso completo e il nome di file da usare per i controlli di discriminazione in base al percorso. Il percorso dell'immagine viene usato anche per aprire e leggere il file per identificare eventuali altri criteri di discriminazione non forniti in questa struttura. Questo membro può essere NULL; tuttavia, se il membro dwCheckFlags include SAFER_CRITERIA_AUTHENTICODE, questo membro o il membro hImageFileHandle deve essere impostato.

hImageFileHandle

Handle di file in un'immagine di codice con almeno GENERIC_READ accesso. L'handle viene usato anziché riaprire in modo esplicito il file per calcolare i criteri di discriminazione non forniti in questa struttura. Questo membro può essere NULL; tuttavia, se dwCheckFlags include SAFER_CRITERIA_AUTHENTICODE, è necessario impostare questo membro o il membro ImagePath .

UrlZoneId

Zone di sicurezza predefinite di Internet Explorer. Le zone seguenti sono definite:

  • URLZONE_LOCAL_MACHINE
  • URLZONE_INTRANET
  • URLZONE_TRUSTED
  • URLZONE_INTERNET
  • URLZONE_UNTRUSTED
Questo membro può essere impostato su 0.

ImageHash[SAFER_MAX_HASH_SIZE]

Hash precomputto dell'immagine. L'hash fornito viene interpretato come valido se sia il membro ImageSize che il membro dwImageHashSize sono non zero e il membro HashAlgorithm contiene un algoritmo di hash valido da Wincrypt.h.

Se l'hash fornito non soddisfa queste condizioni, l'hash viene ricompilate automaticamente da:

  • Uso del membro ImageSize e del membro pByteBlock , se entrambi non sono zero.
  • Uso del membro hImageFileHandle , se non è NULL.
  • Apertura e uso del membro ImagePath , se non è NULL.

dwImageHashSize

Dimensioni, in byte, del membro ImageHash .

ImageSize

Dimensioni, in byte, del membro pByteBlock . Questo membro non viene usato se il membro pByteBlock è NULL.

HashAlgorithm

Algoritmo hash usato per creare il membro ImageHash .

pByteBlock

Blocco di memoria contenente l'immagine del codice controllato. Questo membro è facoltativo. Se questo membro è specificato, è necessario specificare anche il membro ImageSize .

hWndParent

Argomenti usati per la verifica del certificato authenticode signer. Questi argomenti vengono passati alla funzione WinVerifyTrust e controllano l'interfaccia utente che richiede all'utente di accettare o rifiutare i certificati di affidamento.

dwWVTUIChoice

Indica il tipo di interfaccia utente usata. Nella tabella seguente sono illustrati i possibili valori.

Valore Significato
WTD_UI_ALL
 Visualizzare tutte le interfacce utente.
WTD_UI_NONE
 Non visualizzare alcuna interfaccia utente.
WTD_UI_NOBAD
 Visualizzare l'interfaccia utente solo se non sono presenti errori.
WTD_UI_NOGOOD
 Visualizzare l'interfaccia utente solo se si verifica un errore.

Commenti

SAFER_CODE_PROPERTIES è stato ridefinito per includere membri aggiuntivi che consentono all'app di Windows Store di usare la struttura. Controllare il membro cbSize per le dimensioni appropriate della struttura e se è necessario usare la struttura SAFER_CODE_PROPERTIES o la struttura SAFER_CODE_PROPERTIES_V1 .

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione winsafer.h