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