ASSOCF 列舉

提供 IQueryAssociations 介面方法的資訊。

語法

typedef enum  {
    ASSOCF_NONE                  = 0x00000000,  
    ASSOCF_INIT_NOREMAPCLSID     = 0x00000001,  
    ASSOCF_INIT_BYEXENAME        = 0x00000002,  
    ASSOCF_OPEN_BYEXENAME        = 0x00000002,  
    ASSOCF_INIT_DEFAULTTOSTAR    = 0x00000004,  
    ASSOCF_INIT_DEFAULTTOFOLDER  = 0x00000008,  
    ASSOCF_NOUSERSETTINGS        = 0x00000010,  
    ASSOCF_NOTRUNCATE            = 0x00000020,  
    ASSOCF_VERIFY                = 0x00000040,  
    ASSOCF_REMAPRUNDLL           = 0x00000080,  
    ASSOCF_NOFIXUPS              = 0x00000100,  
    ASSOCF_IGNOREBASECLASS       = 0x00000200,  
    ASSOCF_INIT_IGNOREUNKNOWN    = 0x00000400,  
    ASSOCF_INIT_FIXED_PROGID     = 0x00000800,  
    ASSOCF_IS_PROTOCOL           = 0x00001000,  
    ASSOCF_INIT_FOR_FILE         = 0x00002000,
    ASSOCF_IS_FULL_URI           = 0x00004000,
    ASSOCF_PER_MACHINE_ONLY      = 0x00008000,
    ASSOCF_APP_TO_APP            = 0x00010000,
} ASSOCF;

Constants

ASSOCF_NONE

以下選項均未設定。

ASSOCF_INIT_NOREMAPCLSID

指示 IQueryAssociations 介面方法不要將 CLSID 值映射到 ProgID 值。

ASSOCF_INIT_BYEXENAME

將 IQueryAssociations::Init 的 pwszAssoc 參數值識別為可執行檔名稱。 若未設定此標誌,根鍵將被設定為與 .exe 鍵相關的 ProgID,而非執行檔的 ProgID。

ASSOCF_OPEN_BYEXENAME

和 ASSOCF_INIT_BYEXENAME一模一樣。

ASSOCF_INIT_DEFAULTTOSTAR

規定當 IQueryAssociations 方法在根鍵下找不到請求值時,應嘗試從 * 子鍵中取得可比值。

ASSOCF_INIT_DEFAULTTOFOLDER

規定當 IQueryAssociations 方法在根鍵下找不到請求值時,應嘗試從 Folder 子鍵取得可比值。

ASSOCF_NOUSERSETTINGS

規定僅搜尋HKEY_CLASSES_ROOT,HKEY_CURRENT_USER應忽略。

ASSOCF_NOTRUNCATE

規定回傳字串不應被截斷。 取而代之的是回傳錯誤值及完整字串所需的大小。

ASSOCF_VERIFY

指示 IQueryAssociations 的方法驗證資料的準確性。 此設定允許 IQueryAssociations 的方法從使用者硬碟讀取資料以進行驗證。 例如,他們可以將登錄檔中的友善名稱與 .exe 檔案中儲存的名稱進行比對。 設定此標記通常會降低方法效率。

ASSOCF_REMAPRUNDLL

指示 IQueryAssociations 的方法忽略 Rundll.exe 並回傳其目標的資訊。 通常 IQueryAssociations 的方法會回傳指令字串中第一個 .exe 或 .dll 的資訊。 如果指令使用 Rundll.exe,設定此旗標會告訴方法忽略 Rundll.exe 並回傳目標資訊。

ASSOCF_NOFIXUPS

指示 IQueryAssociations 的方法不要修正登錄檔中的錯誤,例如某函式的友善名稱與 .exe 檔案中的名稱不符。

ASSOCF_IGNOREBASECLASS

指定應忽略 BaseClass 值。

ASSOCF_INIT_IGNOREUNKNOWN

於 Windows 7 中引入。 規定「未知」的 ProgID 應被忽略;反而,失敗。

ASSOCF_INIT_FIXED_PROGID

在 Windows 8 中引入。 規定所提供的 ProgID 應以系統預設值來映射,而非目前使用者的預設值。

ASSOCF_IS_PROTOCOL

在 Windows 8 中引入。 指定該值為協定,並應以目前使用者預設值來映射。

ASSOCF_INIT_FOR_FILE

於 Windows 8.1 中引入。 指定 ProgID 對應於基於檔案副檔名的關聯。 與 ASSOCF_INIT_FIXED_PROGID 一起使用。

ASSOCF_IS_FULL_URI

於 Windows 10 週年更新中推出。 指定完整的 http/https URI 正在通過以進行目標解析。 一次只能指定ASSOCF_INIT_FIXED_PROGID、ASSOCF_IS_PROTOCOL或ASSOCF_IS_FULL_URI中的一種。

ASSOCF_PER_MACHINE_ONLY

於 Windows 10 週年更新中推出。 僅強制每台機器的關聯查詢,避免 HKEY_CURRENT_USER。

ASSOCF_APP_TO_APP

於 2018 年 4 月的 Windows 10 更新中引入。 指示 IQueryAssociations 的方法在解析時包含應用程式間的應用(網站應用程式、來自打包應用程式的 URI 處理器)。

Requirements

需求 價值
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
Header Shlwapi.h

參見

AssocQueryKeyAssocQueryStringAssocQueryStringByKey

 

 

© 2017 Microsoft。 著作權所有,並保留一切權利。