IMAGE_ENCLAVE_CONFIG32 structure (winnt.h)

Article
02/02/2024

Définit le format de la configuration de l’enclave pour les systèmes exécutant Windows 32 bits.

Syntaxe

typedef struct _IMAGE_ENCLAVE_CONFIG32 {
  DWORD Size;
  DWORD MinimumRequiredConfigSize;
  DWORD PolicyFlags;
  DWORD NumberOfImports;
  DWORD ImportList;
  DWORD ImportEntrySize;
  BYTE  FamilyID[IMAGE_ENCLAVE_SHORT_ID_LENGTH];
  BYTE  ImageID[IMAGE_ENCLAVE_SHORT_ID_LENGTH];
  DWORD ImageVersion;
  DWORD SecurityVersion;
  DWORD EnclaveSize;
  DWORD NumberOfThreads;
  DWORD EnclaveFlags;
} IMAGE_ENCLAVE_CONFIG32, *PIMAGE_ENCLAVE_CONFIG32;

Membres

Size

Taille de la structure IMAGE_ENCLAVE_CONFIG32 , en octets.

MinimumRequiredConfigSize

Taille minimale de la structure IMAGE_ENCLAVE_CONFIG32 que le chargeur d’images doit être en mesure de traiter pour que l’enclave soit utilisable. Ce membre permet à une enclave d’informer une version antérieure du chargeur d’images que le chargeur d’images peut charger l’enclave en toute sécurité et ignorer les membres facultatifs ajoutés à IMAGE_ENCLAVE_CONFIG32 pour les versions ultérieures de l’enclave. Si la taille de IMAGE_ENCLAVE_CONFIG32 que le chargeur d’images peut traiter est inférieure à MinimumRequiredConfigSize, l’enclave ne peut pas être exécutée en toute sécurité.

Si MinimumRequiredConfigSize est égal à zéro, la taille minimale de la structure IMAGE_ENCLAVE_CONFIG32 que le chargeur d’images doit être en mesure de traiter pour que l’enclave soit utilisable est supposée être la taille de la structure via et y compris le membre MinimumRequiredConfigSize .

PolicyFlags

Indicateur qui indique si l’enclave autorise le débogage.

Valeur	Signification
IMAGE_ENCLAVE_POLICY_DEBUGGABLE `0x00000001`	L’enclave autorise le débogage.
`0x00000000`	L’enclave n’autorise pas le débogage.

NumberOfImports

Nombre d’images dans le tableau d’images vers laquelle le membre ImportList pointe.

ImportList

Adresse virtuelle relative du tableau d’images que l’image d’enclave peut importer, avec des informations d’identité pour chaque image.

ImportEntrySize

Taille de chaque image dans le tableau d’images vers laquelle pointe le membre ImportList .

FamilyID[IMAGE_ENCLAVE_SHORT_ID_LENGTH]

Identificateur de famille attribué à l’enclave par l’auteur de l’enclave.

ImageID[IMAGE_ENCLAVE_SHORT_ID_LENGTH]

Identificateur d’image attribué à l’enclave par l’auteur de l’enclave.

ImageVersion

Numéro de version attribué à l’enclave par l’auteur de l’enclave.

SecurityVersion

Numéro de version de sécurité attribué à l’enclave par l’auteur de l’enclave.

EnclaveSize

Taille virtuelle attendue de la plage d’adresses privées pour l’enclave, en octets.

NumberOfThreads

Nombre maximal de threads pouvant être créés dans l’enclave.

EnclaveFlags

Indicateur qui indique si l’image peut être utilisée comme image principale dans l’enclave.

Valeur	Signification
IMAGE_ENCLAVE_FLAG_PRIMARY_IMAGE `0x00000001`	L’image peut être utilisée comme image principale dans l’enclave.
`0x00000000`	L’image ne peut pas être utilisée comme image principale dans l’enclave.

Remarques

La structure IMAGE_ENCLAVE_CONFIG est définie comme un autre nom pour la structure IMAGE_ENCLAVE_CONFIG32 sur les systèmes qui exécutent Windows 32 bits.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1709 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2016 (applications de bureau uniquement)
En-tête	winnt.h

Voir aussi

Structures d’enclave

IMAGE_ENCLAVE_CONFIG64

Partager via