structure CRYPTUI_WIZ_DIGITAL_SIGN_INFO (cryptuiapi.h)

Article
08/22/2023

[La structure CRYPTUI_WIZ_DIGITAL_SIGN_INFO est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

La structure CRYPTUI_WIZ_DIGITAL_SIGN_INFO contient des informations sur la signature numérique. Cette structure est utilisée par la fonction CryptUIWizDigitalSign .

Syntaxe

typedef struct _CRYPTUI_WIZ_DIGITAL_SIGN_INFO {
  DWORD                                    dwSize;
  DWORD                                    dwSubjectChoice;
  union {
    LPCWSTR                              pwszFileName;
    PCCRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO pSignBlobInfo;
  };
  DWORD                                    dwSigningCertChoice;
  union {
    PCCERT_CONTEXT                           pSigningCertContext;
    PCCRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO    pSigningCertStore;
    PCCRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO pSigningCertPvkInfo;
  };
  LPCWSTR                                  pwszTimestampURL;
  DWORD                                    dwAdditionalCertChoice;
  PCCRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO pSignExtInfo;
} CRYPTUI_WIZ_DIGITAL_SIGN_INFO, *PCRYPTUI_WIZ_DIGITAL_SIGN_INFO;

Membres

dwSize

Taille de la structure en octets.

dwSubjectChoice

Valeur qui indique l’entité à signer. Ce membre est obligatoire si CRYPTUI_WIZ_NO_UI est spécifié dans le paramètre dwFlags de la fonction CryptUIWizDigitalSign . Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOB	L’objet BLOB de mémoire spécifié par le membre pSignBlobInfo doit être signé.
CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILE	Le fichier spécifié par le membre pwszFileName doit être signé.
0	L’utilisateur est invité à signer un fichier.

pwszFileName

Pointeur vers une chaîne Unicode terminée par null qui contient le chemin d’accès et le nom de fichier du fichier à signer. Ce membre est utilisé si CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILE est spécifié pour le membre dwSubjectChoice .

pSignBlobInfo

Pointeur vers une structure CRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO qui contient l’objet BLOB à signer. Ce membre est utilisé si CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOB est spécifié pour le membre dwSubjectChoice .

dwSigningCertChoice

Valeur qui spécifie l’emplacement du certificat utilisé pour signer l’entité. La valeur par défaut est zéro. Il peut s’agir de l’une des valeurs suivantes.

Note Si CRYPTUI_WIZ_NO_UI est spécifié dans le paramètre dwFlags de la fonction CryptUIWizDigitalSign , cette valeur doit être CRYPTUI_WIZ_DIGITAL_SIGN_CERT ou CRYPTUI_WIZ_DIGITAL_SIGN_PVK.

Valeur	Signification
CRYPTUI_WIZ_DIGITAL_SIGN_CERT	Le certificat est contenu dans la structure CERT_CONTEXT pointée par le membre pSigningCertContext .
CRYPTUI_WIZ_DIGITAL_SIGN_STORE	Le certificat est contenu dans le magasin de certificats contenu dans la structure CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO pointée par le membre pSigningCertStore .
CRYPTUI_WIZ_DIGITAL_SIGN_PVK	Le certificat est contenu dans le fichier PVK contenu dans la structure CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO pointée par le membre pSigningCertPvkInfo .
0	Les certificats du magasin My sont utilisés.

pSigningCertContext

Pointeur vers une structure CERT_CONTEXT qui contient le certificat à utiliser pour signer l’entité. Ce membre est utilisé si CRYPTUI_WIZ_DIGITAL_SIGN_CERT est spécifié pour le membre dwSigningCertChoice .

pSigningCertStore

Pointeur vers une structure CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO qui contient le certificat à utiliser pour signer l’entité. Ce membre est utilisé si CRYPTUI_WIZ_DIGITAL_SIGN_STORE est spécifié pour le membre dwSigningCertChoice .

pSigningCertPvkInfo

Pointeur vers une structure CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO qui contient le certificat à utiliser pour signer l’entité. Ce membre est utilisé si CRYPTUI_WIZ_DIGITAL_SIGN_PVK est spécifié pour le membre dwSigningCertChoice .

pwszTimestampURL

Pointeur vers une chaîne Unicode terminée par null qui contient l’URL de l’horodatage.

dwAdditionalCertChoice

Valeur qui indique si des certificats supplémentaires seront inclus dans la signature. La valeur par défaut est zéro. Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN	L’ensemble de la chaîne de certificats sera inclus dans la signature.
CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN_NO_ROOT	Tous les certificats de la chaîne de certificats, à l’exception de la racine, seront inclus dans la signature.
0	Aucun certificat supplémentaire n’est inclus dans la signature.

pSignExtInfo

Pointeur vers une structure CRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO qui contient des informations étendues sur la signature.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	cryptuiapi.h

Voir aussi

CryptUIWizDigitalSign

Partager via