Método IOpcPartSet::D eletePart (msopc.h)

Artículo
02/29/2024

Elimina el puntero de interfaz IOpcPart de un objeto de parte especificado del conjunto.

Sintaxis

HRESULT DeletePart(
  [in] IOpcPartUri *name
);

Parámetros

[in] name

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

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

Cuando se elimina un puntero de interfaz IOpcPart del conjunto, la parte que representa no se serializa cuando se serializa el paquete. Además, si el elemento representado es el origen de una o varias relaciones, esas relaciones no se guardan con el paquete cuando se escribe el objeto de paquete.

Se puede acceder a los datos contenidos en un objeto de elemento eliminado hasta que se libere el objeto de paquete que contiene el objeto de elemento eliminado. Además, una relación cuyo origen es la parte representada por el objeto de elemento eliminado también permanece accesible hasta que se libere el objeto de paquete que contiene el objeto de elemento eliminado. Sin embargo, estas relaciones no se guardarán cuando se guarde el paquete.

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