SHCreateShellFolderView 函式 (shlobj_core.h)

建立預設 Shell 資料夾檢視物件的新實例， (DefView) 。

語法

SHSTDAPI SHCreateShellFolderView(
  [in]  const SFV_CREATE *pcsfv,
  [out] IShellView       **ppsv
);

[in] pcsfv

類型： const SFV_CREATE*

SFV_CREATE 結構的指標，描述建立這個Shell資料夾檢視物件實例時所使用的特定專案。

[out] ppsv

類型： IShellView**

當此函式成功傳回時，會包含新 IShellView 物件的介面指標。失敗時，此值為 NULL。

類型： HRESULT

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

SHCreateShellFolderView 建議使用 SHCreateShellFolderViewEx ，因為其元素參與各種案例、提供新功能給檢視，並與其他對象互動。

處理數個 IShellView 實體時，您可能會想要確認哪一個是預設的 Shell 資料夾檢視物件。若要這樣做，請使用 IID_CDefView IID 在物件上呼叫 QueryInterface 。只有在預設 Shell 資料夾檢視物件上進行時，此呼叫才會成功。

使用預設 Shell 資料夾檢視物件的資料來源必須實作下列介面：

您也可以選擇性地實作 IPersistFolder3。