Funzione CryptUIWizDigitalSign (cryptuiapi.h)

  • Articolo

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

La funzione CryptUIWizDigitalSign firma digitalmente un documento o un BLOB. Il documento o il BLOB può essere firmato con o senza l'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. Può essere zero o il valore seguente.

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

[in, optional] hwndParent

Handle della finestra da utilizzare come elemento padre della finestra di dialogo creata da questa funzione. Questo parametro viene ignorato se il flag 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 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, la funzione restituisce un valore diverso da zero.

Se la funzione ha esito negativo, restituisce zero.

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