SHCreateStreamOnFileEx 函式 (shlwapi.h)

開啟或建立檔案，並擷取資料流程以讀取或寫入該檔案。

語法

LWSTDAPI SHCreateStreamOnFileEx(
  [in]           LPCWSTR pszFile,
  [in]           DWORD   grfMode,
  [in]           DWORD   dwAttributes,
  [in]           BOOL    fCreate,
  [in, optional] IStream *pstmTemplate,
  [out]          IStream **ppstm
);

參數

[in] pszFile

類型： LPCWSTR

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

[in] grfMode

類型： DWORD

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

[in] dwAttributes

類型： DWORD

在建立新檔案的情況下，指定檔案屬性的一或多個旗標值。 如需可能值的完整清單，請參閱CreateFile函式的dwFlagsAndAttributes參數。

[in] fCreate

類型： BOOL

BOOL值，可協助指定與grfMode搭配使用，在建立資料流程時應如何處理現有的檔案。 如需詳細資訊，請參閱。

[in, optional] pstmTemplate

類型： IStream*

保留的。

[out] ppstm

類型： IStream**

接收與檔案相關聯之資料流程的 IStream 介面指標。

傳回值

類型： HRESULT

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

備註

SHCreateStreamOnFileEx函式會擴充STGM旗標的語意，並產生與呼叫CreateFile函式相同的效果。

grfMode和fCreate參數會一起運作，以指定函式在現有檔案方面的行為。

grfMode	fCreate	檔案存在嗎？	行為
STGM_CREATE	忽略	是	檔案會重新建立。
STGM_CREATE	忽略	否	檔案就會建立，
STGM_FAILIFTHERE	FALSE	是	檔案已開啟。
STGM_FAILIFTHERE	FALSE	否	呼叫失敗。
STGM_FAILIFTHERE	TRUE	是	呼叫失敗。
STGM_FAILIFTHERE	TRUE	否	檔案就會建立，

需求

最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	shlwapi.h
程式庫	Shlwapi.lib
Dll	Shlwapi.dll (6.0 版或更新版本)