CRYPTUI_WIZ_DIGITAL_SIGN_INFO-Struktur (cryptuiapi.h)

[Die CRYPTUI_WIZ_DIGITAL_SIGN_INFO-Struktur steht für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Die CRYPTUI_WIZ_DIGITAL_SIGN_INFO-Struktur enthält Informationen zur digitalen Signatur. Diese Struktur wird von der CryptUIWizDigitalSign-Funktion verwendet.

Syntax

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;

Member

dwSize

Die Größe der Struktur in Byte.

dwSubjectChoice

Ein -Wert, der die Entität angibt, die signiert werden soll. Dieser Member ist erforderlich, wenn CRYPTUI_WIZ_NO_UI im dwFlags-Parameter der CryptUIWizDigitalSign-Funktion angegeben ist. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOB	Das vom pSignBlobInfo-Member angegebene Speicherblob muss signiert werden.
CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILE	Die vom pwszFileName-Element angegebene Datei muss signiert werden.
0	Der Benutzer wird aufgefordert, eine Datei zum Signieren einzugeben.

pwszFileName

Ein Zeiger auf eine Unicode-Zeichenfolge, die null endet und den Pfad und Dateinamen der zu signierenden Datei enthält. Dieser Member wird verwendet, wenn CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILE für das dwSubjectChoice-Element angegeben wird.

pSignBlobInfo

Ein Zeiger auf eine CRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO-Struktur , die das zu signierende BLOB enthält. Dieser Member wird verwendet, wenn CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOB für das dwSubjectChoice-Element angegeben wird.

dwSigningCertChoice

Ein -Wert, der den Speicherort des Zertifikats angibt, das zum Signieren der Entität verwendet wird. Der Standardwert ist 0 (null). Dies kann einer der folgenden Werte sein.

Hinweis Wenn CRYPTUI_WIZ_NO_UI im dwFlags-Parameter der CryptUIWizDigitalSign-Funktion angegeben ist, muss dieser Wert entweder CRYPTUI_WIZ_DIGITAL_SIGN_CERT oder CRYPTUI_WIZ_DIGITAL_SIGN_PVK sein.

 

Wert	Bedeutung
CRYPTUI_WIZ_DIGITAL_SIGN_CERT	Das Zertifikat ist in der CERT_CONTEXT Struktur enthalten , auf die das pSigningCertContext-Element verweist.
CRYPTUI_WIZ_DIGITAL_SIGN_STORE	Das Zertifikat ist im Zertifikatspeicher enthalten, der in der CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO Struktur enthalten ist, auf die das pSigningCertStore-Element verweist.
CRYPTUI_WIZ_DIGITAL_SIGN_PVK	Das Zertifikat ist in der PVK-Datei enthalten, die in der CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO Struktur enthalten ist, auf die das pSigningCertPvkInfo-Element verweist.
0	Die Zertifikate im Mein Speicher werden verwendet.

pSigningCertContext

Ein Zeiger auf eine CERT_CONTEXT Struktur, die das Zertifikat enthält, das zum Signieren der Entität verwendet werden soll. Dieser Member wird verwendet, wenn CRYPTUI_WIZ_DIGITAL_SIGN_CERT für das dwSigningCertChoice-Element angegeben wird.

pSigningCertStore

Ein Zeiger auf eine CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO Struktur, die das Zertifikat enthält, das zum Signieren der Entität verwendet werden soll. Dieser Member wird verwendet, wenn CRYPTUI_WIZ_DIGITAL_SIGN_STORE für das dwSigningCertChoice-Element angegeben ist.

pSigningCertPvkInfo

Ein Zeiger auf eine CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO-Struktur , die das Zertifikat enthält, das zum Signieren der Entität verwendet werden soll. Dieser Member wird verwendet, wenn CRYPTUI_WIZ_DIGITAL_SIGN_PVK für das dwSigningCertChoice-Element angegeben ist.

pwszTimestampURL

Ein Zeiger auf eine Unicode-Zeichenfolge, die null endet und die URL für den Zeitstempel enthält.

dwAdditionalCertChoice

Ein -Wert, der angibt, ob zusätzliche Zertifikate in die Signatur eingeschlossen werden. Der Standardwert ist 0 (null). Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN	Die gesamte Zertifikatkette wird in die Signatur eingeschlossen.
CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN_NO_ROOT	Alle Zertifikate in der Zertifikatkette mit Ausnahme des Stamms werden in die Signatur eingeschlossen.
0	Die Signatur enthält keine zusätzlichen Zertifikate.

pSignExtInfo

Ein Zeiger auf eine CRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO-Struktur , die erweiterte Informationen zur Signatur enthält.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	cryptuiapi.h

Weitere Informationen

CryptUIWizDigitalSign