Función CryptUIWizDigitalSign (cryptuiapi.h)
[La función CryptUIWizDigitalSign está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.
La función CryptUIWizDigitalSign firma digitalmente un documento o BLOB. El documento o BLOB se puede firmar con o sin interacción del usuario.
Sintaxis
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
);
Parámetros
[in] dwFlags
Contiene marcas que modifican el comportamiento de la función. Puede ser cero o el valor siguiente.
| Valor | Significado |
|---|---|
|
Esta función firmará el documento en función de la información de la estructura CRYPTUI_WIZ_DIGITAL_SIGN_INFO a la que apunta el parámetro pDigitalSignInfo sin mostrar ninguna interfaz de usuario. Si no se especifica esta marca, esta función mostrará un asistente para guiar al usuario a través del proceso de firma. |
[in, optional] hwndParent
Identificador de la ventana que se va a usar como elemento primario del cuadro de diálogo que crea esta función. Este parámetro se omite si la marca CRYPTUI_WIZ_NO_UI está establecida en dwFlags.
[in, optional] pwszWizardTitle
Puntero a una cadena Unicode terminada en null que contiene el título que se va a usar en el cuadro de diálogo que crea esta función. Este parámetro se omite si la marca CRYPT_WIZ_NO_UI está establecida en dwFlags. Si este parámetro es NULL, se usa un título predeterminado.
[in] pDigitalSignInfo
Puntero a una estructura de CRYPTUI_WIZ_DIGITAL_SIGN_INFO que contiene información sobre el proceso de firma.
[out, optional] ppSignContext
Puntero a un puntero de estructura CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT que recibe el BLOB firmado. Cuando haya terminado de usar esta estructura, debe liberar la memoria pasando este puntero a la función CryptUIWizFreeDigitalSignContext . Este parámetro puede ser NULL si no se necesita el BLOB firmado.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es TRUE.
Si se produce un error en la función, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | cryptuiapi.h |
| Library | Cryptui.lib |
| Archivo DLL | Cryptui.dll |