Método IXpsSignatureRequest::GetRequestId (xpsdigitalsignature.h)
Obtém o identificador exclusivo da solicitação de assinatura.
Sintaxe
HRESULT GetRequestId(
[out, retval] LPWSTR *requestId
);
Parâmetros
[out, retval] requestId
O identificador exclusivo da solicitação de assinatura.
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. |
|
requestId é NULL. |
|
A interface não está conectada ao gerenciador de assinaturas. |
Comentários
Esse método aloca a memória usada pela cadeia de caracteres retornada em requestId. Se requestId não for NULL, use a função CoTaskMemFree para liberar a memória.
O parâmetro requestId recebe o valor do atributo SpotID do elemento SignatureDefinition . O atributo SpotID é necessário e deve seguir o formato xs:ID (ID XML) ; no entanto, as partes SignatureDefinitions existentes não são verificadas quanto à adesão ao formato recomendado. Alguns documentos XPS que foram produzidos por aplicativos Windows Presentation Foundation (WPF) podem ter uma ID que começa com um dígito.
Requisitos
| Requisito | Valor |
|---|---|
| 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 |