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

Artigo
02/29/2024

Exclui o ponteiro da interface IOpcPart de um objeto de parte especificado do conjunto.

Sintaxe

HRESULT DeletePart(
  [in] IOpcPartUri *name
);

Parâmetros

[in] name

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

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

Quando um ponteiro de interface IOpcPart é excluído do conjunto, a parte que ele representa não é serializada quando o pacote é serializado. Além disso, se a parte representada for a origem de uma ou mais relações, essas relações não serão salvas com o pacote quando o objeto de pacote for gravado.

Os dados contidos em um objeto de parte excluído são acessíveis até que o objeto de pacote que contém o objeto de parte excluído seja liberado. Além disso, uma Relação cuja origem é a parte representada pelo objeto de parte excluída também permanece acessível até que o objeto de pacote que contém o objeto de parte excluído seja liberado. No entanto, essas relações não serão salvas quando o pacote for salvo.

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