struttura CRYPTUI_WIZ_DIGITAL_SIGN_INFO (cryptuiapi.h)

  • Articolo

[La struttura CRYPTUI_WIZ_DIGITAL_SIGN_INFO è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

La struttura CRYPTUI_WIZ_DIGITAL_SIGN_INFO contiene informazioni sulla firma digitale. Questa struttura viene usata dalla funzione CryptUIWizDigitalSign .

Sintassi

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;

Members

dwSize

Dimensione, in byte, della struttura.

dwSubjectChoice

Valore che indica l'entità da firmare. Questo membro è obbligatorio se CRYPTUI_WIZ_NO_UI viene specificato nel parametro dwFlags della funzione CryptUIWizDigitalSign . Può trattarsi di uno dei valori seguenti.

Valore Significato
CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOB
 Il BLOB di memoria specificato dal membro pSignBlobInfo deve essere firmato.
CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILE
 Il file specificato dal membro pwszFileName deve essere firmato.
0
 All'utente verrà richiesto di firmare un file.

pwszFileName

Puntatore a una stringa Unicode con terminazione Null che contiene il percorso e il nome file del file da firmare. Questo membro viene utilizzato se CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILE viene specificato per il membro dwSubjectChoice .

pSignBlobInfo

Puntatore a una struttura CRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO che contiene il BLOB da firmare. Questo membro viene utilizzato se CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOB viene specificato per il membro dwSubjectChoice .

dwSigningCertChoice

Valore che specifica il percorso del certificato utilizzato per firmare l'entità. Il valore predefinito è zero. Può trattarsi di uno dei valori seguenti.

Nota Se CRYPTUI_WIZ_NO_UI viene specificato nel parametro dwFlags della funzione CryptUIWizDigitalSign , questo valore deve essere CRYPTUI_WIZ_DIGITAL_SIGN_CERT o CRYPTUI_WIZ_DIGITAL_SIGN_PVK.
 
Valore Significato
CRYPTUI_WIZ_DIGITAL_SIGN_CERT
 Il certificato è contenuto nella struttura CERT_CONTEXT a cui punta il membro pSigningCertContext .
CRYPTUI_WIZ_DIGITAL_SIGN_STORE
 Il certificato è contenuto nell'archivio certificati contenuto nella struttura CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO a cui punta il membro pSigningCertStore .
CRYPTUI_WIZ_DIGITAL_SIGN_PVK
 Il certificato è contenuto nel file PVK contenuto nella struttura CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO a cui punta il membro pSigningCertPvkInfo .
0
 Vengono usati i certificati nell'archivio personale.

pSigningCertContext

Puntatore a una struttura CERT_CONTEXT che contiene il certificato da usare per firmare l'entità. Questo membro viene utilizzato se CRYPTUI_WIZ_DIGITAL_SIGN_CERT viene specificato per il membro dwSigningCertChoice .

pSigningCertStore

Puntatore a una struttura CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO che contiene il certificato da usare per firmare l'entità. Questo membro viene utilizzato se CRYPTUI_WIZ_DIGITAL_SIGN_STORE viene specificato per il membro dwSigningCertChoice .

pSigningCertPvkInfo

Puntatore a una struttura CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO che contiene il certificato da usare per firmare l'entità. Questo membro viene utilizzato se CRYPTUI_WIZ_DIGITAL_SIGN_PVK viene specificato per il membro dwSigningCertChoice .

pwszTimestampURL

Puntatore a una stringa Unicode con terminazione Null che contiene l'URL per il timestamp.

dwAdditionalCertChoice

Valore che indica se nella firma verranno inclusi altri certificati. Il valore predefinito è zero. Può trattarsi di uno dei valori seguenti.

Valore Significato
CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN
 L'intera catena di certificati verrà inclusa nella firma.
CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN_NO_ROOT
 Tutti i certificati nella catena di certificati, ad eccezione della radice, verranno inclusi nella firma.
0
 Nessun certificato aggiuntivo verrà incluso nella firma.

pSignExtInfo

Puntatore a una struttura CRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO contenente informazioni estese sulla firma.

Requisiti

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

Vedi anche

CryptUIWizDigitalSign