AssocQueryKeyA 関数 (shlwapi.h)

レジストリからファイルまたはプロトコルの関連付けに関連するキーを検索して取得します。

構文

LWSTDAPI AssocQueryKeyA(
  [in]  ASSOCF   flags,
  [in]  ASSOCKEY key,
  [in]  LPCSTR   pszAssoc,
  [in]  LPCSTR   pszExtra,
  [out] HKEY     *phkeyOut
);

パラメーター

[in] flags

種類: ASSOCF

検索を制御するために使用できるフラグ。 ASSOCF 値を任意に組み合わせて使用できますが、含めることができるASSOCF_INIT値は 1 つだけです。

[in] key

型: ASSOCKEY

返されるキーの種類を指定する ASSOCKEY 値。

[in] pszAssoc

種類: LPCTSTR

ルート キーを決定するために使用される null で終わる文字列へのポインター。 4 種類の文字列を使用できます。

ファイル名の拡張子

ファイル名拡張子 (.txt など)。

CLSID

標準の "{GUID}" 形式の CLSID GUID。

ProgID

Wordなどのアプリケーションの ProgID。Document.8。

実行可能ファイル名

アプリケーションの .exe ファイルの名前。 ASSOCF_OPEN_BYEXENAME フラグは flags で設定する必要があります。

[in] pszExtra

種類: LPCTSTR

文字列の場所に関する追加情報を含む、null で終わる省略可能な文字列へのポインター。 通常は 、open などのシェル動詞に設定されます。 このパラメーターを使用しない場合は NULL に 設定します。

[out] phkeyOut

種類: HKEY*

キーの HKEY 値へのポインター。

戻り値

型: HRESULT

成功した場合はS_OKを返し、それ以外の場合は COM エラー値を返します。

注釈

この関数は、 IQueryAssociations インターフェイスの ラッパーです。 インターフェイスを使用するプロセスを簡略化することを目的としています。 ファイルとプロトコルの関連付け関数のしくみの詳細については、「 IQueryAssociations」を参照してください。

注意

shlwapi.h ヘッダーは、ASsocQueryKey をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shlwapi.h
Library	Shlwapi.lib
[DLL]	Shlwapi.dll (バージョン 5.0 以降)