ASSOCSTR 列挙 (shlwapi.h)

  • [アーティクル]

IQueryAssociations::GetString によって、返される文字列の型を定義するために使用されます。

構文

typedef enum {
  ASSOCSTR_COMMAND = 1,
  ASSOCSTR_EXECUTABLE,
  ASSOCSTR_FRIENDLYDOCNAME,
  ASSOCSTR_FRIENDLYAPPNAME,
  ASSOCSTR_NOOPEN,
  ASSOCSTR_SHELLNEWVALUE,
  ASSOCSTR_DDECOMMAND,
  ASSOCSTR_DDEIFEXEC,
  ASSOCSTR_DDEAPPLICATION,
  ASSOCSTR_DDETOPIC,
  ASSOCSTR_INFOTIP,
  ASSOCSTR_QUICKTIP,
  ASSOCSTR_TILEINFO,
  ASSOCSTR_CONTENTTYPE,
  ASSOCSTR_DEFAULTICON,
  ASSOCSTR_SHELLEXTENSION,
  ASSOCSTR_DROPTARGET,
  ASSOCSTR_DELEGATEEXECUTE,
  ASSOCSTR_SUPPORTED_URI_PROTOCOLS,
  ASSOCSTR_PROGID,
  ASSOCSTR_APPID,
  ASSOCSTR_APPPUBLISHER,
  ASSOCSTR_APPICONREFERENCE,
  ASSOCSTR_MAX
} ASSOCSTR;

定数

 
ASSOCSTR_COMMAND
値: 1
シェル動詞に関連付けられたコマンド文字列。
ASSOCSTR_EXECUTABLE
シェル動詞コマンド文字列からの実行可能ファイル。 たとえば、この文字列は、次のようなサブキーの (既定値) 値として見つかります。

\ HKEY_CLASSES_ROOTApplicationname\シェル\開く\コマンド。 コマンドで Rundll.exe を使用する場合は、IQueryAssociations::GetString の flags パラメーターに ASSOCF_REMAPRUNDLL フラグを設定して、ターゲット実行可能ファイルを取得します。

注意  

すべてのアプリの関連付けに実行可能ファイルがあるわけではありません。 実行可能ファイルが常に存在することを想定しないでください。


 

この種類の文字列は、動詞の実装で呼び出されるコードを識別します。
ASSOCSTR_FRIENDLYDOCNAME
ドキュメントの種類のフレンドリ名。
ASSOCSTR_FRIENDLYAPPNAME
実行可能ファイルのフレンドリ名。
ASSOCSTR_NOOPEN
開いているサブキーに関連付けられている情報は無視します。
ASSOCSTR_SHELLNEWVALUE
ShellNew サブキーの下を見てください。
ASSOCSTR_DDECOMMAND
DDE コマンド用のテンプレート。
ASSOCSTR_DDEIFEXEC
プロセスの作成に使用する DDE コマンド。
ASSOCSTR_DDEAPPLICATION
DDE ブロードキャスト内のアプリケーション名。
ASSOCSTR_DDETOPIC
DDE ブロードキャストのトピック名。
ASSOCSTR_INFOTIP
ヒント レジストリ値に対応します。 アイテムの情報ヒント、または IPropertyDescriptionList 形式のプロパティの一覧を返します。このリストは、ファイル名の上にカーソルを置くときなど、ヒントの作成元となります。 プロパティの一覧は 、PSGetPropertyDescriptionListFromString を使用して解析できます。
ASSOCSTR_QUICKTIP
インターネット エクスプローラー 6 で導入されました。 QuickTip レジストリ値に対応します。 ASSOCSTR_INFOTIPと同じですが、 IPropertyDescriptionList の形式でプロパティ名の一覧が常に返される点が除きます。 この値とASSOCSTR_INFOTIPの違いは、オフラインネットワークや低速ネットワークなど、低速なプロパティ取得を引き起こすシナリオで安全なプロパティを返すということです。 ASSOCSTR_INFOTIPから返されるプロパティの一部は、低速のプロパティ取得シナリオには適していない場合があります。 プロパティの一覧は 、PSGetPropertyDescriptionListFromString を使用して解析できます。
ASSOCSTR_TILEINFO
インターネット エクスプローラー 6 で導入されました。 TileInfo レジストリ値に対応します。 タイル ビューにある Windows エクスプローラー ウィンドウで特定のファイルの種類に対して表示されるプロパティの一覧が含まれます。 これはASSOCSTR_INFOTIPと同じですが、ASSOCSTR_QUICKTIPと同様に、プロパティ名のリストも IPropertyDescriptionList の形式で返されます。 プロパティの一覧は 、PSGetPropertyDescriptionListFromString を使用して解析できます。
ASSOCSTR_CONTENTTYPE
インターネット エクスプローラー 6 で導入されました。 アプリケーションが特定のファイルの種類に関する一般的な前提を立てることができるように、image や bmp などの一般的な種類の MIME ファイルの関連付けを記述します。
ASSOCSTR_DEFAULTICON
インターネット エクスプローラー 6 で導入されました。 この関連付けに既定で使用するアイコン リソースへのパスを返します。 正の数値は dll のリソース テーブルへのインデックスを示し、負の数はリソース ID を示します。 リソースの構文の例として、"c:\myfolder\myfile.dll,-1" があります。
ASSOCSTR_SHELLEXTENSION
インターネット エクスプローラー 6 で導入されました。 シェル拡張機能が関連付けられているオブジェクトの場合は、これを使用して、取得するインターフェイスの IID の文字列表現を IQueryAssociations::GetString の pwszExtra パラメーターとして渡すことで、その Shell 拡張オブジェクトの CLSID を取得できます。 たとえば、 IExtractImage インターフェイスを実装するハンドラーを取得する場合は、 IExtractImage の IID である "{BB2E617C-0920-11d1-9A0B-00C04FC2D6C1}" を指定します。
ASSOCSTR_DROPTARGET
インターネット エクスプローラー 8 で導入されました。 COM および IDropTarget インターフェイスを介して呼び出された動詞の場合、このフラグを使用して IDropTarget オブジェクトの CLSID を取得できます。 この CLSID は DropTarget サブキーに登録されます。 動詞は、IQueryAssociations::GetString の呼び出しの pwszExtra パラメーターで指定されます。

この種類の文字列は、動詞の実装で呼び出されるコードを識別します。
ASSOCSTR_DELEGATEEXECUTE
インターネット エクスプローラー 8 で導入されました。 COM および IExecuteCommand インターフェイスを介して呼び出された動詞の場合、このフラグを使用して IExecuteCommand オブジェクトの CLSID を取得できます。 この CLSID は、動詞の コマンド サブキーに DelegateExecute エントリとして登録されます。 動詞は、IQueryAssociations::GetString の呼び出しの pwszExtra パラメーターで指定されます。

この種類の文字列は、動詞の実装で呼び出されるコードを識別します。
ASSOCSTR_SUPPORTED_URI_PROTOCOLS
URI プロトコル スキームの文字列値。 たとえば、 http:https:ftp:file: または * すべてを示します。
ASSOCSTR_PROGID
Windows 10で導入されました。 ファイルの種類または URI スキームに関連付けられているアプリによって提供される ProgID。 これは、ユーザーが既定のプログラム設定で構成した場合です。
ASSOCSTR_APPID
Windows 10で導入されました。 ファイルの種類または URI スキームに関連付けられているアプリの AppUserModelID。 これは、既定のプログラム設定でユーザーによって構成されます。
ASSOCSTR_APPPUBLISHER
Windows 10で導入されました。 ファイルの種類または URI スキームに関連付けられているアプリの発行元。 これは、既定のプログラム設定でユーザーによって構成されます。
ASSOCSTR_APPICONREFERENCE
Windows 10で導入されました。 ファイルの種類または URI スキームに関連付けられているアプリのアイコン参照。 これは、既定のプログラム設定でユーザーによって構成されます。
ASSOCSTR_MAX
検証目的で使用される、定義された ASSOCSTR の最大値。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional、Windows XP、Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header shlwapi.h