Funzione CryptUIWizDigitalSign (cryptuiapi.h)

Articolo
05/30/2024

[La funzione CryptUIWizDigitalSign è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può essere modificato o non disponibile nelle versioni successive.

La funzione CryptUIWizDigitalSign firma digitalmente un documento o UN BLOB. Il documento o IL BLOB possono essere firmati con o senza interazione dell'utente.

Sintassi

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
);

Parametri

[in] dwFlags

Contiene flag che modificano il comportamento della funzione. Questo valore può essere zero o il valore seguente.

Valore	Significato
CRYPTUI_WIZ_NO_UI 0x0001	Questa funzione firma il documento in base alle informazioni nella struttura CRYPTUI_WIZ_DIGITAL_SIGN_INFO puntata dal parametro pDigitalSignInfo senza visualizzare alcuna interfaccia utente. Se questo flag non è specificato, questa funzione visualizzerà una procedura guidata per guidare l'utente tramite il processo di firma.

[in, optional] hwndParent

Handle della finestra da usare come padre della finestra di dialogo creata da questa funzione. Questo parametro viene ignorato se il flag di CRYPTUI_WIZ_NO_UI è impostato in dwFlags.

[in, optional] pwszWizardTitle

Puntatore a una stringa Unicode con terminazione null contenente il titolo da usare nella finestra di dialogo creata da questa funzione. Questo parametro viene ignorato se il flag di CRYPT_WIZ_NO_UI è impostato in dwFlags. Se questo parametro è NULL, viene usato un titolo predefinito.

[in] pDigitalSignInfo

Puntatore a una struttura CRYPTUI_WIZ_DIGITAL_SIGN_INFO che contiene informazioni sul processo di firma.

[out, optional] ppSignContext

Puntatore a un puntatore alla struttura CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT che riceve il BLOB firmato. Al termine dell'uso di questa struttura, è necessario liberare la memoria passando questo puntatore alla funzione CryptUIWizFreeDigitalSignContext . Questo parametro può essere NULL se il BLOB firmato non è necessario.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

Se la funzione ha esito negativo, il valore restituito è FALSE. Per informazioni sull'errore estese, chiamare GetLastError.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	cryptuiapi.h
Libreria	Cryptui.lib
DLL	Cryptui.dll

Vedi anche

CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT

CRYPTUI_WIZ_DIGITAL_SIGN_INFO

CryptUIWizFreeDigitalSignContext

Condividi tramite