Método IOpcPartSet::GetPart (msopc.h)

Artigo
03/05/2024

Obtém um objeto part, que representa uma parte especificada, no conjunto.

Sintaxe

HRESULT GetPart(
  [in]          IOpcPartUri *name,
  [out, retval] IOpcPart    **part
);

Parâmetros

[in] name

Um ponteiro para a interface IOpcPartUri do objeto URI de parte que representa o nome da parte de uma parte.

[out, retval] part

Um ponteiro para a IOpcPart do objeto part que representa a parte que tem o nome da parte especificado.

Retornar valor

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 name é NULL.
OPC_E_NO_SUCH_PART 0x80510018	A parte 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 URI de parte	Um código de erro HRESULT do Grupo de Erros do URI de Parte.

Comentários

Para recuperar o ponteiro da interface IOpcPart do objeto part que representa uma parte específica, chame o método PartExists e passe o nome da parte para confirmar se a parte está representada no conjunto. Se for, chame o método GetPart e passe o nome da parte para recuperar o ponteiro da interface IOpcPart .

Se o objeto URI da parte representar o nome da parte de uma parte Relações, esse método falhará porque as partes Relações não estão incluídas no conjunto.

A interface IOpcPart fornece acesso às propriedades de uma parte. Para obter detalhes sobre essas propriedades, consulte Visão geral de partes e IOpcPart.

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