Share via

CryptUIWizDigitalSign-Funktion (cryptuiapi.h)

  • Artikel

[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
CRYPTUI_WIZ_NO_UI
0x0001
 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, gibt die Funktion ungleich null zurück.

Wenn die Funktion fehlschlägt, wird null zurückgegeben.

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

Weitere Informationen

CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT

CRYPTUI_WIZ_DIGITAL_SIGN_INFO

CryptUIWizFreeDigitalSignContext