Método IOpcRelationshipSet::GetRelationship (msopc.h)

Obtém um objeto de relação do conjunto que representa uma relação especificada.

Sintaxe

HRESULT GetRelationship(
  [in]          LPCWSTR          relationshipIdentifier,
  [out, retval] IOpcRelationship **relationship
);

[in] relationshipIdentifier

O identificador exclusivo de uma relação.

[out, retval] relationship

Um ponteiro para a interface IOpcRelationship do objeto de relação que representa a relação que tem o identificador especificado.

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

Valor/código retornado	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	O parâmetro de relação é NULL.
OPC_E_NO_SUCH_RELATIONSHIP 0x80510048	A relação especificada não existe.
Erro de consumo de pacote	Um código de erro HRESULT do Grupo de Erros de Consumo de Pacote.
Erro de parte do URI	Um código de erro HRESULT do Grupo de Erros do URI da Parte.

A interface IOpcRelationship fornece acesso às propriedades de relação. Para obter detalhes sobre essas propriedades, consulte Visão geral de relações e IOpcRelationship.

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

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

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