StgOpenLayoutDocfile 函式 (objbase.h)

發行項
03/05/2024

不支援。

StgOpenLayoutDocfile 函式會在能夠監視扇區數據的 ILockBytes 實作上開啟複合檔案。若要呼叫 StgOpenLayoutDocfile，需要 DfLayout.dll 和 DfLayout.lib。

注意請勿使用此函式。請改用 IStorage：：CopyTo 方法。 CopyTo 可用來配置 docfile，因此在大部分情況下改善效能。

語法

HRESULT StgOpenLayoutDocfile(
  [in]  OLECHAR const *pwcsDfName,
  [in]  DWORD         grfMode,
  [in]  DWORD         reserved,
  [out] IStorage      **ppstgOpen
);

參數

[in] pwcsDfName

要開啟之複合檔案之 Null 終止 Unicode 字串名稱的指標。

[in] grfMode

開啟新建立的儲存物件時要使用的存取模式。值取自 STGM 常數。請注意，不支援優先順序模式和排除專案。最常見的存取模式可能STGM_DIRECT |STGM_READ |STGM_SHARE_EXCLUSIVE。

[in] reserved

保留供未來使用。

[out] ppstgOpen

IStorage 指標變數的指標，接收新建立之根記憶體物件之根對象的介面指標。

傳回值

除了下列專案外，此函式支援標準傳回值E_OUTOFMEMORY、E_UNEXPECTED、E_INVALIDARG和E_FAIL：

StgOpenLayoutDocfile 函式也可以傳回 StgOpenStorageOnILockBytes 函式所傳回的任何錯誤值。

備註

此函式所建立的複合檔案實作會在其根記憶體上公開 ILayoutStorage 介面。應用程式會使用此介面來表達其複合檔案的最佳配置，以便透過慢速鏈接下載和轉譯數據。 StgOpenLayoutDocfile 會傳回新建立之複合檔案根記憶體上 IStorage 介面的指標。使用此指標，應用程式會呼叫 QueryInterface 以取得 ILayoutStorage 的指標。