PifMgr_OpenProperties函式 (shlobj_core.h)
[PifMgr_OpenProperties 可用於需求一節中指定的操作系統。 後續版本可能會變更或無法使用。]
開啟與 Microsoft MS-DOS 應用程式相關聯的 .pif 檔案，並傳回應用程式的屬性句柄。
語法
HANDLE PifMgr_OpenProperties(
[in] PCWSTR pszApp,
[in, optional] PCWSTR pszPIF,
UINT hInf,
UINT flOpt
);
參數
[in] pszApp
類型： PCWSTR
以 Null 結尾的 Unicode 字串，其中包含應用程式的名稱。
[in, optional] pszPIF
類型： PCWSTR
以 Null 結尾的 Unicode 字串，其中包含 .pif 檔案的名稱。
hInf
類型： UINT
應用程式的 .inf 檔案句柄。 如果沒有 .inf 檔案，請將此值設定為零。 將此值設定為 -1，以防止處理 .inf 檔案。
flOpt
類型： UINT
控制函式運作方式的旗標。
OPENPROPS_INHIBITPIF
忽略任何現有的 .pif 檔案，並從 win.ini 或 _Default.pif 取得屬性。 Windows NT、Windows 2000 和 Windows XP 上會忽略此旗標。
OPENPROPS_NONE
未指定選項。
傳回值
類型： HANDLE
傳回應用程式屬性的句柄。 當您呼叫相關的 .pif 函式時，請使用此句柄。
備註
您不應該將 PifMgr_OpenProperties 視為在某處開啟檔案的函式。 此呼叫之後，.pif 檔案不會保持開啟狀態。 將函式視為您可以使用磁碟數據初始化的屬性結構配置器，會比較有用。 此函式失敗的主要原因，是因為記憶體不足或無法開啟指定的 .pif 檔案。
如果沒有任何 .pif 檔案存在，函式仍會在記憶體中配置數據區塊，並使用數據從 _Default.pif 或其內部預設值初始化它。 如果函式尋找 .pif 檔名，但找不到它，它會建構名稱，並將它儲存在其內部 .pif 數據結構中。 這可確保如果 呼叫 PifMgr_SetProperties ，數據就會儲存至磁碟。
如果函式找不到 .pif 檔案，它會依下列順序搜尋它。
- 搜尋目前的目錄。
- 搜尋指定的目錄。
- 在 .pif 目錄中搜尋。
- 搜尋PATH環境變數所指定的資料夾。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | shlobj_core.h |
| 程式庫 | Shell32.lib |
| Dll | Shell32.dll (5.0 版或更新版本) |