IQueryAssociations：：Init 方法 （shlwapi.h）

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

語法

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

參數

[in] flags

類型： ASSOCF

一個標示搜尋初始化方式的旗標。 它通常設為零，但也可以採用以下 ASSOCF 值之一。

• ASSOCF_INIT_BYEXENAME
• ASSOCF_INIT_DEFAULTTOFOLDER
• ASSOCF_INIT_DEFAULTTOSTAR

[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 方法時，會以此為起點，並搜尋根鍵子鍵中的資訊。

需求

另請參閱

IQuery協會