Metodo IOpcPartSet::GetPart (msopc.h)

Articolo
02/29/2024

Ottiene un oggetto part, che rappresenta una parte specificata, nel set.

Sintassi

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

Parametri

[in] name

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

[out, retval] part

Puntatore all'oggetto IOpcPart dell'oggetto part che rappresenta la parte con il nome della parte specificato.

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

Per recuperare il puntatore dell'interfaccia IOpcPart dell'oggetto part che rappresenta una parte specifica, chiamare il metodo PartExists e passare il nome della parte per verificare che la parte sia rappresentata nel set. In caso affermativo, chiamare il metodo GetPart e passare il nome della parte per recuperare il puntatore dell'interfaccia IOpcPart .

Se l'oggetto URI della parte rappresenta il nome della parte di una parte Relazioni, questo metodo avrà esito negativo perché le parti Relazioni non sono incluse nel set.

L'interfaccia IOpcPart consente di accedere alle proprietà di una parte. Per informazioni dettagliate su queste proprietà, vedere Panoramica delle parti e IOpcPart.

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