IQueryAssociations：：Init 方法 (shlwapi.h)

發行項
03/09/2024

初始化 IQueryAssociations 介面，並將根索引鍵設定為適當的 ProgID。

語法

HRESULT Init(
  [in]           ASSOCF  flags,
  [in, optional] LPCWSTR pszAssoc,
  [in, optional] HKEY    hkProgid,
  [in, optional] HWND    hwnd
);

參數

[in] flags

類型： ASSOCF

旗標，指定要如何初始化搜尋。它通常會設定為零，但也可以採用下列其中一個 ASSOCF 值。

[in, optional] pszAssoc

類型： LPCWSTR

用來判斷根索引鍵的 Unicode 字串。如果為 hkProgid 指定值，請將此參數設定為 NULL。可以使用四種類型的字串：

副檔名

擴展名，例如 .txt。

CLSID

標準 “{GUID}” 格式的 CLSID GUID。

ProgID

應用程式的 ProgID，例如 Word。Document.8.

可執行檔名稱

應用程式 .exe 檔的名稱。 ASSOCF_OPEN_BYEXENAME旗標必須在旗標中設定。

[in, optional] hkProgid

類型： HKEY

做為根索引鍵之子機碼的 HKEY 值。搜尋只會在此機碼下方顯示。如果為 pwszAssoc 指定值，請將此參數設定為 NULL。

[in, optional] hwnd

類型： HWND

傳回值

類型： HRESULT

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

備註

這個方法會初始化介面，而且每次您需要指定新的根索引鍵時，也會呼叫。您可以使用 pwszAssoc 來指定字串，例如擴展名或其相關聯的 ProgID，以識別根索引鍵。您也可以指定根金鑰的 HKEY 值。 Init 接著會使用此資訊在登錄中找出根機碼。後續呼叫其他 IQueryAssociations 方法會使用它作為起點，並搜尋根索引鍵子機碼中的資訊。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	shlwapi.h
程式庫	Shlwapi.lib
Dll	Shell32.dll (5.0 版或更新版本)

另請參閱

IQueryAssociations

共用方式為