Metodo IOpcPartSet::D eletePart (msopc.h)

Articolo
03/05/2024

Elimina il puntatore dell'interfaccia IOpcPart di un oggetto parte specificato dal set.

Sintassi

HRESULT DeletePart(
  [in] IOpcPartUri *name
);

Parametri

[in] name

Puntatore all'interfaccia IOpcPartUri dell'oggetto URI della parte che rappresenta il nome della parte.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice/valore restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro name è NULL.
OPC_E_NO_SUCH_PART 0x80510018	La parte specificata non esiste.
Errore di consumo del pacchetto	Codice di errore HRESULT dal gruppo di errori consumo pacchetto.
Errore dell'URI parte	Codice di errore HRESULT dal gruppo di errori dell'URI parte.

Commenti

Quando un puntatore dell'interfaccia IOpcPart viene eliminato dal set, la parte che rappresenta non viene serializzata quando il pacchetto viene serializzato. Inoltre, se la parte rappresentata è l'origine di una o più relazioni, tali relazioni non vengono salvate con il pacchetto quando l'oggetto pacchetto viene scritto.

I dati contenuti in un oggetto part eliminato sono accessibili fino a quando non viene rilasciato l'oggetto package contenente l'oggetto part eliminato. Inoltre, un oggetto Relationship il cui origine è la parte rappresentata dall'oggetto part eliminato rimane accessibile fino a quando non viene rilasciato l'oggetto package contenente l'oggetto part eliminato. Tuttavia, queste relazioni non verranno salvate quando il pacchetto viene salvato.

Thread safety

Gli oggetti di creazione dei pacchetti non sono thread-safe.

Per altre informazioni, vedere l'Introduzione con l'API Creazione pacchetti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	msopc.h