Metodo IOpcFactory::CreateStreamOnFile (msopc.h)

Crea un flusso su un file. Questo metodo è un wrapper semplificato per una chiamata alla funzione CreateFile . I parametri CreateFile non esposti tramite questo metodo usano i valori predefiniti. Per altre informazioni, vedere CreateFile.

Sintassi

HRESULT CreateStreamOnFile(
  [in]          LPCWSTR               filename,
  [in]          OPC_STREAM_IO_MODE    ioMode,
  [in]          LPSECURITY_ATTRIBUTES securityAttributes,
  [in]          DWORD                 dwFlagsAndAttributes,
  [out, retval] IStream               **stream
);

Parametri

[in] filename

Nome del file su cui viene creato il flusso.

[in] ioMode

Valore che descrive lo stato di lettura/scrittura del flusso da creare.

[in] securityAttributes

Per informazioni sulla struttura SECURITY_ATTRIBUTES in questo parametro, vedere la funzione CreateFile .

[in] dwFlagsAndAttributes

Impostazioni e attributi del file. Per la maggior parte dei file, è possibile usare FILE_ATTRIBUTE_NORMAL .

Per altre informazioni su questo parametro, vedere CreateFile.

[out, retval] stream

Puntatore all'interfaccia IStream del flusso.

Valore restituito

Il metodo restituisce un 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 ioMode non è un valore di enumerazione valido OPC_STREAM_IO_MODE .
E_POINTER
Almeno uno dei parametri di file e flusso è NULL.
Errore della funzione CreateFile
Codice di errore HRESULT dalla funzione CreateFile .

Commenti

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

Per informazioni sull'uso di questo metodo durante il caricamento o il salvataggio di un pacchetto, vedere l'attività Caricamento di un pacchetto o salvataggio di un pacchetto .

Supporto nelle versioni precedenti di Windows

Il comportamento e le prestazioni di questo metodo sono uguali in tutte le versioni di Windows supportate. Per altre informazioni, vedere Introduzione con l'API Creazione pacchetti e l'aggiornamento della piattaforma per Windows Vista.

Thread safety

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

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

Requisiti

   
Client minimo supportato Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione msopc.h

Vedi anche

CreateFile

ECMA-376 OpenXML

Risorse esterne

Introduzione con l'API Creazione pacchetti

IOpcFactory

Caricamento di un pacchetto

OPC_STREAM_IO_MODE

Cenni preliminari

Guida alla programmazione dell'API per la creazione di pacchetti

Informazioni di riferimento sulle API per la creazione di pacchetti

Esempi di API di creazione di pacchetti

Errori di creazione pacchetti

Panoramica delle parti

Aggiornamento della piattaforma per Windows Vista

RFC 3986: sintassi generica URI

Riferimento

Salvataggio di un pacchetto