Metodo IOpcFactory::WritePackageToStream (msopc.h)

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 HRESULT. I valori possibili includono, ma non solo, quelli nella tabella seguente.

Codice restituito Description
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 utilizzo del pacchetto
 Codice di errore HRESULT del gruppo di errori del consumo del pacchetto.
Errore URI parte
 Codice di errore HRESULT del gruppo di errori URI parte.

Osservazioni:

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 .

Supporto per le versioni precedenti di Windows

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

Sicurezza dei Thread

I pacchetti di oggetti non sono thread-safe.

Per altre informazioni, vedere Introduzione all'API di creazione di pacchetti.

Requisiti

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

Vedere anche

Introduzione all'API di creazione di pacchetti

IOpcFactory

OPC_WRITE_FLAGS

Panoramiche

Guida alla programmazione dell'API per la creazione di pacchetti

Informazioni di riferimento sulle API per la creazione di pacchetti

Esempi di API per la creazione di pacchetti

Errori di creazione pacchetti

Aggiornamento della piattaforma per Windows Vista

Riferimento

Salvataggio di un pacchetto

  • Last updated on