IApplicationAssociationRegistration::QueryCurrentDefault 方法 (shobjidl_core.h)
決定指定關聯型別的默認應用程式。 這是 ShellExecute 針對該類型所啟動的預設應用程式。
語法
HRESULT QueryCurrentDefault(
[in] LPCWSTR pszQuery,
[in] ASSOCIATIONTYPE atQueryType,
[in] ASSOCIATIONLEVEL alQueryLevel,
[out] LPWSTR *ppszAssociation
);
參數
[in] pszQuery
類型: LPCWSTR
以 Null 結尾的 Unicode 字串指標,其中包含擴展名或通訊協定,例如 .mp3 或 HTTP。
[in] atQueryType
類型: ASSOCIATIONTYPE
其中一個 ASSOCIATIONTYPE 列舉值,指定關聯類型,例如延伸模組或 MIME 類型。
[in] alQueryLevel
類型: ASSOCIATIONLEVEL
其中一個 ASSOCIATIONLEVEL 列舉值,指定關聯層級,例如每一使用者或計算機。 這通常是 AL_EFFECTIVE。
[out] ppszAssociation
類型: LPWSTR*
當這個方法傳回時,會包含識別目前默認關聯之 ProgID 指標的位址。
注意 呼叫應用程式必須負責透過 CoTaskMemFree 釋放字串。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
產生的字串通常是與已註冊應用程式相關聯的其中一個 ProgID 相符的 ProgID,但有一些例外狀況:如果傳回的字串是計算機預設通訊協定,則會是舊版字符串,指出 .exe 處理程式的命令行,而不是 ProgID。 同樣地,如果傳回機器預設的MIME類型,它會傳回舊版類別標識碼, (CLSID) 字串,而不是 ProgID。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | shobjidl_core.h (包含 Shobjidl.h) |