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

Artículo
02/29/2024

Obtiene un objeto part, que representa una parte especificada, en el conjunto.

Sintaxis

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

Parámetros

[in] name

Puntero a la interfaz IOpcPartUri del objeto URI de parte que representa el nombre de parte de un elemento.

[out, retval] part

Puntero al IOpcPart del objeto part que representa el elemento que tiene el nombre de la parte especificada.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código o valor devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_POINTER	El parámetro name es NULL.
OPC_E_NO_SUCH_PART 0x80510018	La parte especificada no existe.
Error de consumo de paquetes	Código de error HRESULT del grupo de errores de consumo de paquetes.
Error de URI de parte	Código de error HRESULT del grupo de errores de URI de parte.

Comentarios

Para recuperar el puntero de interfaz IOpcPart del objeto part que representa una parte específica, llame al método PartExists y pase el nombre del elemento para confirmar que la parte está representada en el conjunto. Si es así, llame al método GetPart y pase el nombre del elemento para recuperar el puntero de interfaz IOpcPart .

Si el objeto URI de parte representa el nombre de elemento de una parte Relaciones, este método producirá un error porque las partes De relaciones no se incluyen en el conjunto.

La interfaz IOpcPart proporciona acceso a las propiedades de una parte. Para obtener más información sobre estas propiedades, consulte Información general de los elementos e IOpcPart.

Seguridad para subprocesos

Los objetos de empaquetado no son seguros para subprocesos.

Para más información, consulte la Introducción con la API de empaquetado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msopc.h