Metodo IOpcFactory::WritePackageToStream (msopc.h)

Articolo
03/08/2023

Serializza un pacchetto rappresentato da un oggetto pacchetto.

Sintassi

HRESULT WritePackageToStream(
  [in] IOpcPackage     *package,
  [in] OPC_WRITE_FLAGS flags,
  [in] IStream         *stream
);

Parametri

[in] package

Puntatore all'interfaccia IOpcPackage dell'oggetto pacchetto che contiene dati da serializzare.

[in] flags

Valore che descrive il metodo di codifica utilizzato nella serializzazione.

[in] stream

Puntatore all'interfaccia IStream del flusso in cui verranno scritti i dati dell'oggetto pacchetto.

Valore restituito

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

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_INVALIDARG	Il valore passato nel parametro flags non è un valore di enumerazione OPC_WRITE_FLAGS valido.
E_NOTIMPL	Questo metodo non è implementato per questa versione di Windows.
E_POINTER	Almeno uno dei parametri del flusso e del pacchetto è NULL.
Errore dell'interfaccia IStream	Codice di errore HRESULT dall'interfaccia IStream .
Errore di consumo del pacchetto	Codice di errore HRESULT del gruppo di errori di consumo del pacchetto.
Errore dell'URI della parte	Codice di errore HRESULT del gruppo di errori URI parte.

Commenti

Non usare un flusso per serializzare i dati del pacchetto quando viene usato lo stesso flusso per deserializzare un pacchetto, perché il tentativo può comportare un comportamento non definito.

Per informazioni su come utilizzare questo metodo per salvare un pacchetto rappresentato come oggetto pacchetto, vedere l'attività Salvataggio di un pacchetto di programmazione.

Supporto nelle versioni precedenti di Windows

Questo metodo non è supportato nelle versioni di Windows precedenti a Windows 7. Per altre informazioni, vedere Introduzione con l'API per la creazione di pacchetti e l'aggiornamento della piattaforma per Windows Vista.

Thread safety

I pacchetti degli oggetti non sono thread-safe.

Per altre informazioni, vedere l'Introduzione con l'API per la creazione di 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