Función CryptUIWizDigitalSign (cryptuiapi.h)

  • Artículo

[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
CRYPTUI_WIZ_NO_UI
0x0001
 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 ejecuta correctamente, la función devuelve un valor distinto de cero.

Si se produce un error en la función, devuelve cero.

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

Consulte también

CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT

CRYPTUI_WIZ_DIGITAL_SIGN_INFO

CryptUIWizFreeDigitalSignContext