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

Artigo
10/26/2023

Obtém o tipo de relação.

Sintaxe

HRESULT GetRelationshipType(
  [out, retval] LPWSTR *relationshipType
);

Parâmetros

[out, retval] relationshipType

Recebe o tipo de relação, que é o nome qualificado da relação, conforme definido pelo designer de formato de pacote ou pelo OPC.

Para obter mais informações sobre tipos de relação, consulte Comentários.

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

Comentários

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

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

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

Para obter mais informações sobre relações, tipos de relação e uma lista de tipos de relação definidos pelo OPC, consulte Os Conceitos básicos das Convenções de Empacotamento Aberto e o 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


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