Compartilhar via


Método IOpcSignatureReference::GetId (msopc.h)

Obtém o identificador da referência.

Sintaxe

HRESULT GetId(
  [out, retval] LPWSTR *referenceId
);

Parâmetros

[out, retval] referenceId

Um identificador para a referência.

Se o identificador não estiver definido, referenceId 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 referenceId é NULL.

Comentários

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

Fornecer um identificador para uma referência é opcional. Se usado, o identificador é serializado como o atributo de ID opcional de um elemento Reference na marcação de assinatura.

Acesso thread-safe

Os objetos de empacotamento não são thread-safe.

Para obter mais informações, consulte o Introdução com a API de Empacotamento.

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

Confira também

Interfaces de empacotamento principais

Introdução com a API de Empacotamento

IOpcSignatureReference

Visões gerais

Guia de programação da API de empacotamento

Referência da API de empacotamento

Exemplos de API de empacotamento

Empacotando interfaces de assinatura digital

Interfaces de empacotamento

Referência