Compartilhar via


Função CryptUIWizDigitalSign (cryptuiapi.h)

[A função CryptUIWizDigitalSign está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

A função CryptUIWizDigitalSign assina digitalmente um documento ou BLOB. O documento ou BLOB pode ser assinado com ou sem interação do usuário.

Sintaxe

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

Contém sinalizadores que modificam o comportamento da função. Isso pode ser zero ou o valor a seguir.

Valor Significado
CRYPTUI_WIZ_NO_UI
0x0001
Essa função assinará o documento com base nas informações na estrutura CRYPTUI_WIZ_DIGITAL_SIGN_INFO apontada pelo parâmetro pDigitalSignInfo sem exibir nenhuma interface do usuário. Se esse sinalizador não for especificado, essa função exibirá um assistente para orientar o usuário durante o processo de assinatura.

[in, optional] hwndParent

O identificador da janela a ser usada como o pai da caixa de diálogo que essa função cria. Esse parâmetro será ignorado se o sinalizador CRYPTUI_WIZ_NO_UI estiver definido em dwFlags.

[in, optional] pwszWizardTitle

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o título a ser usado na caixa de diálogo que essa função cria. Esse parâmetro será ignorado se o sinalizador CRYPT_WIZ_NO_UI estiver definido em dwFlags. Se esse parâmetro for NULL, um título padrão será usado.

[in] pDigitalSignInfo

Um ponteiro para uma estrutura CRYPTUI_WIZ_DIGITAL_SIGN_INFO que contém informações sobre o processo de assinatura.

[out, optional] ppSignContext

Um ponteiro para um ponteiro de estrutura CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT que recebe o BLOB assinado. Quando terminar de usar essa estrutura, você deverá liberar a memória passando esse ponteiro para a função CryptUIWizFreeDigitalSignContext . Esse parâmetro poderá ser NULL se o BLOB assinado não for necessário.

Retornar valor

Se a função for bem-sucedida, o valor retornado será TRUE.

Se a função falhar, o valor retornado será FALSE. Para obter informações de erro estendidas, chame GetLastError.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho cryptuiapi.h
Biblioteca Cryptui.lib
DLL Cryptui.dll

Confira também

CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT

CRYPTUI_WIZ_DIGITAL_SIGN_INFO

CryptUIWizFreeDigitalSignContext