SHELLEXECUTEINFOA 構造体 (shellapi.h)

ShellExecuteExで使用される情報を格納します。

構文

typedef struct _SHELLEXECUTEINFOA {
  DWORD     cbSize;
  ULONG     fMask;
  HWND      hwnd;
  LPCSTR    lpVerb;
  LPCSTR    lpFile;
  LPCSTR    lpParameters;
  LPCSTR    lpDirectory;
  int       nShow;
  HINSTANCE hInstApp;
  void      *lpIDList;
  LPCSTR    lpClass;
  HKEY      hkeyClass;
  DWORD     dwHotKey;
  union {
    HANDLE hIcon;
    HANDLE hMonitor;
  } DUMMYUNIONNAME;
  HANDLE    hProcess;
} SHELLEXECUTEINFOA, *LPSHELLEXECUTEINFOA;

メンバーズ

cbSize

型: DWORD

必須。 この構造体のサイズ (バイト単位)。

fMask

型: ULONG

他の構造体メンバーの内容と有効性を示す、次の値の 1 つ以上の組み合わせ。

hwnd

型: HWND

随意。 所有者ウィンドウへのハンドル。この関数の実行中にシステムによって生成される可能性のある UI を表示および配置するために使用されます。

lpVerb

型: LPCTSTR

実行するアクションを指定する、動詞と呼ばれる文字列。 使用可能な動詞のセットは、特定のファイルまたはフォルダーによって異なります。 一般に、オブジェクトのショートカット メニューから使用できるアクションは、動詞として使用できます。 このパラメーターは NULLできます。この場合、既定の動詞が使用されます (使用可能な場合)。 そうでない場合は、"open" 動詞が使用されます。 どちらの動詞も使用できない場合、システムはレジストリに記載されている最初の動詞を使用します。 アクションを特定の動詞に制限する理由がない限り、計算された既定値を使用するには NULL を渡します。 これは、SEE_MASK_FLAG_NO_UIを指定する場合や、アプリがインストールされていない場合に "Open With" UI を生成することを目的とした場合などに必要になります。

次の動詞が一般的に使用されます。

• 編集: エディターを起動し、編集用にドキュメントを開きます。 lpFile ドキュメント ファイルでない場合、関数は失敗します。
• を調べる: lpFileで指定されたフォルダー 調べられます。
• を検索 : 指定したディレクトリから検索を開始します。
• を開 : lpFile パラメーターで指定されたファイルを開きます。 ファイルには、実行可能ファイル、ドキュメント ファイル、またはフォルダーを指定できます。
• openas: ユーザーが、lpFile パラメーターで指定されたファイルを開くアプリを選択できるピッカー UI を起動します。
• 印刷: lpFileで指定されたドキュメント ファイル 印刷します。 lpFile ドキュメント ファイルでない場合、関数は失敗します。
• プロパティ: ファイルまたはフォルダーのプロパティを表示します。
• runas: 管理者としてアプリケーションを起動します。 ユーザー アカウント制御 (UAC) は、アプリケーションを管理者特権で実行するか、アプリケーションの実行に使用する管理者アカウントの資格情報を入力する同意をユーザーに求めます。

lpFile

型: LPCTSTR

shellExecuteEx が lpVerb パラメーターで指定されたアクション を実行するファイルまたはオブジェクトの名前を指定する null で終わる文字列のアドレス。 ShellExecuteEx 関数でサポートされているシステム レジストリ動詞には、実行可能ファイルとドキュメント ファイルの "開く" と、印刷ハンドラーが登録されているドキュメント ファイルの "印刷" が含まれます。 他のアプリケーションでは、.avi ファイルや.wav ファイルの "再生" など、システム レジストリを介してシェル動詞が追加されている場合があります。 シェル名前空間オブジェクトを指定するには、完全修飾解析名を渡し、fMask パラメーターに SEE_MASK_INVOKEIDLIST フラグを設定します。

lpParameters

型: LPCTSTR

随意。 アプリケーション パラメーターを含む null で終わる文字列のアドレス。 パラメーターはスペースで区切る必要があります。 lpFile メンバーがドキュメント ファイルを指定する場合は、lpParameters NULLする必要があります。

lpDirectory

型: LPCTSTR

随意。 作業ディレクトリの名前を指定する null で終わる文字列のアドレス。 このメンバーが NULL場合、現在のディレクトリが作業ディレクトリとして使用されます。

nShow

型: int

必須。 アプリケーションを開くときに表示する方法を指定するフラグ。ShellExecute 関数に一覧表示されているSW_値の 1 つ。 lpFile ドキュメント ファイルを指定する場合、フラグは関連付けられているアプリケーションに渡されます。 その処理方法を決めるのはアプリケーションの判断です。

hInstApp

型: HINSTANCE

[out]SEE_MASK_NOCLOSEPROCESSが設定され、ShellExecuteEx 呼び出しが成功した場合、このメンバーは 32 より大きい値に設定されます。 関数が失敗した場合は、エラーの原因を示すSE_ERR_XXXエラー値に設定されます。 hInstApp は、16 ビット Windows アプリケーションとの互換性のために HINSTANCE として宣言されていますが、実際の HINSTANCE ではありません。 これは、32 または次のSE_ERR_XXXエラー コードと比較して、int にのみキャストできます。

lpIDList

型: LPVOID

実行するファイルを一意に識別する項目識別子リストを格納する絶対 ITEMIDLIST 構造体 (PCIDLIST_ABSOLUTE) のアドレス。 fMask メンバーに SEE_MASK_IDLIST または SEE_MASK_INVOKEIDLISTが含まれていない場合、このメンバーは無視されます。

lpClass

型: LPCTSTR

次のいずれかを指定する null で終わる文字列のアドレス。

• ProgId。 たとえば、"Paint.Picture" などです。
• URI プロトコル スキーム。 たとえば、"http" などです。
• ファイル拡張子。 たとえば、".txt" などです。
• 1 つ以上のシェル動詞を含むサブキーに名前を付HKEY_CLASSES_ROOTの下のレジストリ パス。 このキーには、シェル動詞レジストリ スキーマに準拠するサブキーが含まれます。たとえば、シェル動詞名します。

fMask SEE_MASK_CLASSNAMEが含まれていない場合、このメンバーは無視されます。

hkeyClass

型: HKEY

ファイルの種類のレジストリ キーへのハンドル。 このレジストリ キーのアクセス権は、KEY_READに設定する必要があります。 fMask SEE_MASK_CLASSKEYが含まれていない場合、このメンバーは無視されます。

dwHotKey

型: DWORD

アプリケーションに関連付けるキーボード ショートカット。 下位ワードは仮想キー コードであり、上位ワードは修飾子フラグ (HOTKEYF_) です。 修飾子フラグの一覧については、WM_SETHOTKEY メッセージの説明を参照してください。 fMask SEE_MASK_HOTKEYが含まれていない場合、このメンバーは無視されます。

DUMMYUNIONNAME

DUMMYUNIONNAME.hIcon

型: HANDLE

ファイルの種類のアイコンへのハンドル。 fMask SEE_MASK_ICONが含まれていない場合、このメンバーは無視されます。 この値は、Windows XP 以前でのみ使用されます。 Windows Vista の時点では無視されます。

DUMMYUNIONNAME.hMonitor

型: HANDLE

ドキュメントを表示するモニターのハンドル。 fMask SEE_MASK_HMONITORが含まれていない場合、このメンバーは無視されます。

hProcess

型: HANDLE

新しく開始されたアプリケーションのハンドル。 このメンバーは戻り値に設定され、fMask が SEE_MASK_NOCLOSEPROCESSに設定されていない限り、常に NULL 。 fMask が SEE_MASK_NOCLOSEPROCESSに設定されている場合でも、プロセス 起動されなかった場合、hProcess は NULL されます。 たとえば、起動するドキュメントが URL で、Internet Explorer のインスタンスが既に実行されている場合は、ドキュメントが表示されます。 新しいプロセスは起動されません。hProcess は NULLされます。

備考

SEE_MASK_NOASYNC フラグは、ShellExecuteEx 呼び出すスレッドにメッセージ ループがない場合、または ShellExecuteEx が戻った直後にスレッドまたはプロセス 終了する場合に指定する必要があります。 このような状況では、呼び出し元スレッドは DDE 会話を完了できないため、呼び出し元アプリケーションに制御を返す前に、ShellExecuteEx 会話を完了することが重要です。 会話を完了しないと、ドキュメントの起動に失敗する可能性があります。

呼び出し元のスレッドにメッセージ ループがあり、ShellExecuteEx の呼び出し 戻ってからしばらく存在する場合、SEE_MASK_NOASYNC フラグは省略可能です。 フラグを省略すると、呼び出し元スレッドのメッセージ ポンプを使用して DDE 会話が完了します。 DDE の会話はバックグラウンドで完了できるため、呼び出し元のアプリケーションは制御を早く回復します。

lpParametersに二重引用符 含めるには、次の例のように、各マークを二重引用符で囲みます。

sei.lpParameters = "An example: \"\"\"quoted text\"\"\"";

この場合、アプリケーションは 3 つのパラメーターを受け取ります。、例:、"引用符で囲まれたテキスト"。

必要条件