| UID | title | description | helpviewer_keywords | old-location | tech.root | ms.assetid | ms.date | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | req.redist | ms.custom | f1_keywords | dev_langs | topic_type | api_type | api_location | api_name | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NS:winsafer._SAFER_CODE_PROPERTIES_V1 |
SAFER_CODE_PROPERTIES_V1 (winsafer.h) |
Contains code image information and criteria to be checked on the code image. (SAFER_CODE_PROPERTIES_V1) |
|
security\safer_code_properties_v1.htm |
security |
E09D287B-7223-4CAF-B404-61FB6871B622 |
12/05/2018 |
*PSAFER_CODE_PROPERTIES_V1, PSAFER_CODE_PROPERTIES_V1, PSAFER_CODE_PROPERTIES_V1 structure pointer [Security], SAFER_CODE_PROPERTIES_V1, SAFER_CODE_PROPERTIES_V1 [Security] See also,SAFER_CODE_PROPERTIES [Security], SAFER_CODE_PROPERTIES_V1 [Security], SAFER_CODE_PROPERTIES_V1 structure [Security], SAFER_CRITERIA_AUTHENTICODE, SAFER_CRITERIA_IMAGEHASH, SAFER_CRITERIA_IMAGEPATH, SAFER_CRITERIA_IMAGEPATH_NT, SAFER_CRITERIA_URLZONE, security.safer_code_properties_v1, winsafer/PSAFER_CODE_PROPERTIES_V1, winsafer/SAFER_CODE_PROPERTIES_V1 |
winsafer.h |
Windows |
Windows XP [desktop apps only] |
Windows Server 2003 [desktop apps only] |
Windows |
SAFER_CODE_PROPERTIES_V1, *PSAFER_CODE_PROPERTIES_V1 |
19H1 |
|
|
|
|
|
|
The SAFER_CODE_PROPERTIES_V1 structure contains code image information and criteria to be checked on the code image. An array of SAFER_CODE_PROPERTIES_V1 structures is passed to the SaferIdentifyLevel function.
SAFER_CODE_PROPERTIES_V1 does not include the new members for Windows Store app packages. Existing binary callers can distinguish which version by checking the cbSize member.
The size, in bytes, of this structure. This is used for future and backward compatibility.
The types of criteria considered when evaluating this structure. Some flags might be silently ignored if some or all of their associated structure elements are not supplied. Specifying zero for this parameter causes the entire structure's contents to be ignored.
The following table shows the possible values. These values can be combined by using a bitwise-OR operation.
A string that specifies the fully qualified path and file name to be used for discrimination checks based on the path. The image path is also used to open and read the file to identify any other discrimination criteria not supplied in this structure. This member can be NULL; however, if the dwCheckFlags member includes SAFER_CRITERIA_AUTHENTICODE, either this member or the hImageFileHandle member must be set.
A file handle to a code image with at least GENERIC_READ access. The handle is used instead of explicitly reopening the file to compute discrimination criteria not supplied in this structure. This member can be NULL; however, if dwCheckFlags includes SAFER_CRITERIA_AUTHENTICODE, either this member or the ImagePath member must be set.
The predetermined Internet Explorer security zones. The following zones are defined:
- URLZONE_LOCAL_MACHINE
- URLZONE_INTRANET
- URLZONE_TRUSTED
- URLZONE_INTERNET
- URLZONE_UNTRUSTED
The precomputed hash of the image. The supplied hash is interpreted as valid if both the ImageSize member and the dwImageHashSize member are nonzero and the HashAlgorithm member contains a valid hashing algorithm from Wincrypt.h.
If the supplied hash fails to meet these conditions, the hash is automatically recomputed by:
- Using the ImageSize member and the pByteBlock member, if both are nonzero.
- Using the hImageFileHandle member, if it is not NULL.
- Opening and using the ImagePath member, if it is not NULL.
The size, in bytes, of the ImageHash member.
The size, in bytes, of the pByteBlock member. This member is not used if the pByteBlock member is NULL.
The hash algorithm used to create the ImageHash member.
The memory block that contains the image of the code being checked. This member is optional. If this member is specified, the ImageSize member must also be supplied.
The arguments used for Authenticode signer certificate verification. These arguments are passed to the WinVerifyTrust function and control the UI that prompts the user to accept or reject entrusted certificates.
Indicates the type of UI used. The following table shows the possible values.
| Value | Meaning |
|---|---|
|
Display all UI. |
|
Display no UI. |
|
Display UI only if there were no errors. |
|
Display UI only if an error occurs. |
SAFER_CODE_PROPERTIES was redefined to include additional members that allow Windows Store app to use the structure. Check the cbSize member for the appropriate size of the structure and for whether you should use the SAFER_CODE_PROPERTIES structure or the SAFER_CODE_PROPERTIES_V1 structure.