Metodo IOpcFactory::CreateStreamOnFile (msopc.h)

Articolo
11/11/2023

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 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 ioMode non è un valore di enumerazione valido OPC_STREAM_IO_MODE .
E_POINTER	Almeno uno dei parametri di nome 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 viene usato lo stesso flusso per deserializzare un pacchetto, perché il tentativo può comportare 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 gli stessi in tutte le versioni di Windows supportate. 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, 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