CryptUIWizDigitalSign-Funktion (cryptuiapi.h)
[Die CryptUIWizDigitalSign-Funktion ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]
Die CryptUIWizDigitalSign-Funktion signiert ein Dokument oder blob digital. Das Dokument oder blob kann mit oder ohne Benutzerinteraktion signiert werden.
Syntax
BOOL CryptUIWizDigitalSign(
[in] DWORD dwFlags,
[in, optional] HWND hwndParent,
[in, optional] LPCWSTR pwszWizardTitle,
[in] PCCRYPTUI_WIZ_DIGITAL_SIGN_INFO pDigitalSignInfo,
[out, optional] PCCRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT *ppSignContext
);
Parameter
[in] dwFlags
Enthält Flags, die das Verhalten der Funktion ändern. Dies kann null oder der folgende Wert sein.
| Wert | Bedeutung |
|---|---|
|
Diese Funktion signiert das Dokument basierend auf den Informationen in der CRYPTUI_WIZ_DIGITAL_SIGN_INFO Struktur, auf die der pDigitalSignInfo-Parameter verweist, ohne eine Benutzeroberfläche anzuzeigen. Wenn dieses Flag nicht angegeben ist, zeigt diese Funktion einen Assistenten an, der den Benutzer durch den Signierungsprozess führt. |
[in, optional] hwndParent
Das Handle des Fensters, das als übergeordnetes Element des Dialogfelds verwendet werden soll, das von dieser Funktion erstellt wird. Dieser Parameter wird ignoriert, wenn das flag CRYPTUI_WIZ_NO_UI in dwFlags festgelegt ist.
[in, optional] pwszWizardTitle
Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Termin, die den Titel enthält, der im Dialogfeld verwendet werden soll, das von dieser Funktion erstellt wird. Dieser Parameter wird ignoriert, wenn das CRYPT_WIZ_NO_UI-Flag in dwFlags festgelegt ist. Wenn dieser Parameter NULL ist, wird ein Standardtitel verwendet.
[in] pDigitalSignInfo
Ein Zeiger auf eine CRYPTUI_WIZ_DIGITAL_SIGN_INFO-Struktur , die Informationen zum Signierungsprozess enthält.
[out, optional] ppSignContext
Ein Zeiger auf einen CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT-Strukturzeiger, der das signierte BLOB empfängt. Wenn Sie die Verwendung dieser Struktur abgeschlossen haben, müssen Sie den Speicher freigeben, indem Sie diesen Zeiger an die CryptUIWizFreeDigitalSignContext-Funktion übergeben. Dieser Parameter kann NULL sein, wenn das signierte BLOB nicht benötigt wird.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.
Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | cryptuiapi.h |
| Bibliothek | Cryptui.lib |
| DLL | Cryptui.dll |