AssocQueryKeyA 関数 (shlwapi.h)

[アーティクル]
11/20/2024

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

構文

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.Document.8などのアプリケーションの ProgID。

実行可能ファイル名

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

[in] pszExtra

型: LPCTSTR

文字列の場所に関する追加情報を含む、省略可能な null で終わる文字列へのポインター。通常は、開いているなどのシェル動詞設定されます。このパラメーターを使用しない場合は、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 [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	shlwapi.h
ライブラリ	Shlwapi.lib
DLL	Shlwapi.dll (バージョン 5.0 以降)

次の方法で共有