Método IOpcDigitalSignature::GetSignatureId (msopc.h)

Artigo
03/05/2024

Obtém o valor do atributo Id do elemento Signature da marcação de assinatura.

Sintaxe

HRESULT GetSignatureId(
  [out, retval] LPWSTR *signatureId
);

Parâmetros

[out, retval] signatureId

Um ponteiro para o valor do atributo Id do elemento Signature de marcação de assinatura.

Se o elemento Signature não tiver um valor de atributo Id , signatureId será a cadeia de caracteres vazia.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	O parâmetro signatureId é NULL.

Comentários

Esse método aloca memória usada pela cadeia de caracteres retornada em signatureId. Se o método for bem-sucedido, chame a função CoTaskMemFree para liberar a memória.

O atributo Id do elemento Signature é opcional. Se esse método não for chamado, o elemento Signature não terá o atributo Id .

Para definir a ID de assinatura antes que a assinatura seja gerada, chame o método IOpcSigningOptions::SetSignatureId .

Para acessar a ID antes que a assinatura seja gerada, chame IOpcSigningOptions::GetSignatureId. método.

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	msopc.h