Método IXpsSignatureBlock::CreateRequest (xpsdigitalsignature.h)
Cria uma nova interface IXpsSignatureRequest e a adiciona ao bloco de assinatura.
Sintaxe
HRESULT CreateRequest(
[in] LPCWSTR requestId,
[out, retval] IXpsSignatureRequest **signatureRequest
);
Parâmetros
[in] requestId
Uma cadeia de caracteres que identifica exclusivamente a nova solicitação de assinatura dentro do bloco de assinatura. Para que o método gere uma cadeia de caracteres de ID, defina esse parâmetro como NULL.
[out, retval] signatureRequest
Um ponteiro para a nova interface IXpsSignatureRequest . Se o acesso à nova interface de solicitação não for necessário, esse parâmetro poderá ser definido como NULL.
Retornar valor
O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam, 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 interface não está conectada ao gerenciador de assinaturas ou requestId é NULL e uma cadeia de caracteres de ID exclusiva não pôde ser gerada. |
Comentários
A nova solicitação de assinatura deve ter uma ID de solicitação exclusiva; nenhuma solicitação pode ter a mesma cadeia de caracteres de ID.
A criação de uma nova solicitação marca o bloco de assinatura como sujo e gera um novo conteúdo para a parte SignatureDefinitions. Quando o pacote XPS for serializado, o novo conteúdo substituirá o conteúdo anterior na parte SignatureDefinitions.
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 |