estructura CRYPTUI_WIZ_DIGITAL_SIGN_INFO (cryptuiapi.h)

[La estructura CRYPTUI_WIZ_DIGITAL_SIGN_INFO está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

La estructura CRYPTUI_WIZ_DIGITAL_SIGN_INFO contiene información sobre la firma digital. Esta estructura la usa la función CryptUIWizDigitalSign .

Sintaxis

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;

Miembros

dwSize

Tamaño, en bytes, de la estructura.

dwSubjectChoice

Valor que indica la entidad que se va a firmar. Este miembro es necesario si se especifica CRYPTUI_WIZ_NO_UI en el parámetro dwFlags de la función CryptUIWizDigitalSign . Puede ser uno de los siguientes valores.

Valor	Significado
CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOB	El BLOB de memoria especificado por el miembro pSignBlobInfo se va a firmar.
CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILE	El archivo especificado por el miembro pwszFileName se va a firmar.
0	Se le pedirá al usuario que firme un archivo.

pwszFileName

Puntero a una cadena Unicode terminada en null que contiene la ruta de acceso y el nombre de archivo del archivo que se va a firmar. Este miembro se usa si se especifica CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILE para el miembro dwSubjectChoice .

pSignBlobInfo

Puntero a una estructura de CRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO que contiene el BLOB que se va a firmar. Este miembro se usa si se especifica CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOB para el miembro dwSubjectChoice .

dwSigningCertChoice

Valor que especifica la ubicación del certificado que se usa para firmar la entidad. El valor predeterminado es cero. Puede ser uno de los siguientes valores.

Nota Si CRYPTUI_WIZ_NO_UI se especifica en el parámetro dwFlags de la función CryptUIWizDigitalSign , este valor debe ser CRYPTUI_WIZ_DIGITAL_SIGN_CERT o CRYPTUI_WIZ_DIGITAL_SIGN_PVK.

 

Valor	Significado
CRYPTUI_WIZ_DIGITAL_SIGN_CERT	El certificado se encuentra en la estructura CERT_CONTEXT a la que apunta el miembro pSigningCertContext .
CRYPTUI_WIZ_DIGITAL_SIGN_STORE	El certificado está incluido en el almacén de certificados contenido en la estructura CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO a la que apunta el miembro pSigningCertStore .
CRYPTUI_WIZ_DIGITAL_SIGN_PVK	El certificado se encuentra en el archivo PVK contenido en la estructura CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO a la que apunta el miembro pSigningCertPvkInfo .
0	Se usan los certificados de Mi almacén.

pSigningCertContext

Puntero a una estructura de CERT_CONTEXT que contiene el certificado que se va a usar para firmar la entidad. Este miembro se usa si se especifica CRYPTUI_WIZ_DIGITAL_SIGN_CERT para el miembro dwSigningCertChoice .

pSigningCertStore

Puntero a una estructura de CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO que contiene el certificado que se va a usar para firmar la entidad. Este miembro se usa si se especifica CRYPTUI_WIZ_DIGITAL_SIGN_STORE para el miembro dwSigningCertChoice .

pSigningCertPvkInfo

Puntero a una estructura de CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO que contiene el certificado que se va a usar para firmar la entidad. Este miembro se usa si se especifica CRYPTUI_WIZ_DIGITAL_SIGN_PVK para el miembro dwSigningCertChoice .

pwszTimestampURL

Puntero a una cadena Unicode terminada en null que contiene la dirección URL de la marca de tiempo.

dwAdditionalCertChoice

Valor que indica si se incluirán certificados adicionales en la firma. El valor predeterminado es cero. Puede ser uno de los siguientes valores.

Valor	Significado
CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN	Toda la cadena de certificados se incluirá en la firma.
CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN_NO_ROOT	Todos los certificados de la cadena de certificados, excepto la raíz, se incluirán en la firma.
0	No se incluirá ningún certificado adicional en la firma.

pSignExtInfo

Puntero a una estructura CRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO que contiene información extendida sobre la firma.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	cryptuiapi.h

Consulte también

CryptUIWizDigitalSign