SHCreateStreamOnFileA 函式 (shlwapi.h)

[SHCreateStreamOnFile 可用於需求一節中指定的操作系統。它在後續版本中可能會變更或無法使用。請改用 SHCreateStreamOnFileEx。]

開啟或建立檔案，並擷取數據流以讀取或寫入該檔案。

語法

LWSTDAPI SHCreateStreamOnFileA(
  [in]  LPCSTR  pszFile,
  [in]  DWORD   grfMode,
  [out] IStream **ppstm
);

[in] pszFile

類型： LPCTSTR

指定檔名之 Null 終止字串的指標。

[in] grfMode

類型： DWORD

一或多個 STGM 值，用來指定檔案存取模式，以及如何建立和刪除公開數據流的物件。

[out] ppstm

類型： IStream**

接收與檔案相關聯之數據流的 IStream 介面指標。

類型： HRESULT

如果此函式成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

SHCreateStreamOnFileEx 完全支援所有 STGM 模式，並允許呼叫端在建立新檔案時指定檔案屬性。

注意

shlwapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 SHCreateStreamOnFile 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。