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

Artigo
03/09/2024

Obtém o identificador exclusivo da relação.

Sintaxe

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

Parâmetros

[out, retval] relationshipIdentifier

O identificador da relação.

O identificador de uma relação é arbitrário e local para o pacote e, portanto, .

Identificadores válidos estão em conformidade com as restrições para xsd:ID, que estão documentadas na seção 3.3.8 ID da Recomendação W3C, Esquema XML Parte 2: Datatypes Second Edition (http://www.w3.org/TR/xmlschema-2/#ID).

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 relationshipIdentifier é NULL.

Comentários

O identificador de uma relação não é útil para localizar relações porque é arbitrário e local para o pacote.

A maneira definitiva de encontrar uma parte do interesse é usando um tipo de relação.

Encontrar uma parte requer várias etapas. Para obter informações detalhadas sobre como encontrar uma parte, consulte Localizando a parte de propriedades principais.

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

Para obter mais informações sobre relações, consulte Open Packaging Conventions Fundamentals and the ECMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC).

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