iOpcFactory：：CreateStreamOnFile 方法 (msopc.h)

發行項
03/05/2024

在檔案上建立數據流。這個方法是呼叫 CreateFile 函式的簡化包裝函式。未透過此方法公開的 CreateFile 參數會使用其預設值。如需詳細資訊，請參閱 CreateFile。

語法

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

參數

[in] filename

建立數據流的檔名。

[in] ioMode

值，描述要建立之數據流的讀取/寫入狀態。

[in] securityAttributes

如需此參數中 SECURITY_ATTRIBUTES 結構的相關信息，請參閱 CreateFile 函式。

[in] dwFlagsAndAttributes

檔案的設定和屬性。對於大部分的檔案，可以使用 FILE_ATTRIBUTE_NORMAL 。

如需此參數的詳細資訊，請參閱 CreateFile。

[out, retval] stream

數據流之 IStream 介面的指標。

傳回值

方法會傳回 HRESULT。可能的值包括 (但不限於) 下表中的這些值。

傳回碼	描述
S_OK	此方法已成功。
E_INVALIDARG	在 ioMode 參數中傳遞的值不是有效的OPC_STREAM_IO_MODE列舉值。
E_POINTER	至少有一個檔名和數據流參數為 NULL。
CreateFile 函式錯誤	CreateFile 函式中的 HRESULT 錯誤碼。

備註

當相同的數據流用來還原串行化封裝時，請勿使用數據流來串行化封裝數據，因為嘗試可能會導致未定義的行為。

如需在載入或儲存封裝時使用此方法的相關信息，請參閱載入套件或儲存套件程序設計工作。

舊版 Windows 的支援

此方法的行為和效能在所有支援的 Windows 版本上都相同。如需詳細資訊，請參閱使用封裝 API 和適用於 Windows Vista 的平臺更新使用者入門。

執行緒安全性

封裝物件不是安全線程。

如需詳細資訊，請參閱使用封裝 API 使用者入門。

規格需求

需求	值
最低支援的用戶端	適用於 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [僅限桌面]
目標平台	Windows
標頭	msopc.h