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

CLSID 値を ProgID 値にマップしないように IQueryAssociations インターフェイス メソッドに指示します。

ASSOCF_INIT_BYEXENAME

IQueryAssociations::Init の pwszAssoc パラメーターの値を実行可能ファイル名として識別します。 このフラグが設定されていない場合、ルート キーは、実行可能ファイルの ProgID ではなく 、.exe キーに関連付けられている 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

Rundll.exe を無視し、そのターゲットに関する情報を返すように IQueryAssociations メソッドに指示します。 通常 、IQueryAssociations メソッドは、コマンド文字列内の最初の .exe または .dll に関する情報を返します。 コマンドで Rundll.exeを使用する場合、このフラグを設定すると、メソッドは Rundll.exe を無視し、そのターゲットに関する情報を返すように指示します。

ASSOCF_NOFIXUPS

.exe ファイルで見つかった関数のフレンドリ名など、レジストリ内のエラーを修正しないように IQueryAssociations メソッドに指示します。

ASSOCF_IGNOREBASECLASS

BaseClass 値を無視することを指定します。

ASSOCF_INIT_IGNOREUNKNOWN

Windows 7で導入されました。 "Unknown" 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 Anniversary Update で導入されました。 ターゲット解決のために完全な http/https URI が渡されることを指定します。 一度に指定できるASSOCF_INIT_FIXED_PROGID、ASSOCF_IS_PROTOCOL、またはASSOCF_IS_FULL_URIの 1 つだけです。

ASSOCF_PER_MACHINE_ONLY

Windows 10 Anniversary Update で導入されました。 マシンごとの関連付けの検索のみを適用し、 HKEY_CURRENT_USERを回避します。

ASSOCF_APP_TO_APP

2018 年 4 月Windows 10更新プログラムで導入されました。 解決時にアプリ間 (Web サイト用アプリ、パッケージ アプリからの URI ハンドラー) を含むように IQueryAssociations メソッドに指示します。

必要条件

こちらも参照ください

AssocQueryKeyAssocQueryStringAssocQueryStringByKey

© 2017 Microsoft。 All rights reserved.