Método IXpsSignatureRequest::GetIntent (xpsdigitalsignature.h)
Define a cadeia de caracteres que descreve a intenção ou o significado da assinatura.
Sintaxe
HRESULT GetIntent(
[out, retval] LPWSTR *intent
);
Parâmetros
[out, retval] intent
O contrato de intenção de assinatura contra o qual o signatário está assinando.
Retornar valor
O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir. Para obter valores retornados que não estão listados nesta tabela, consulte Erros de API de Assinatura Digital XPS e Erros de Documento XPS.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
a intenção é NULL. |
|
A interface não está conectada ao gerenciador de assinaturas. |
Comentários
A cadeia de caracteres de intenção de assinatura descreve o que a assinatura significa para o signatário. Por exemplo, para a cadeia de caracteres de intenção de assinatura "Li e concordo com o conteúdo deste documento" a presença de uma assinatura digital significa que o signatário leu e concorda com o conteúdo do documento.
Esse método aloca a memória usada pela cadeia de caracteres retornada na intenção. Se a intenção não for NULL, use a função CoTaskMemFree para liberar a memória.
Requisitos
| Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | xpsdigitalsignature.h |