SHELLEXECUTEINFOA-Struktur (shellapi.h)

Enthält Informationen, die von ShellExecuteExverwendet werden.

Syntax

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;

Angehörige

cbSize

Typ: DWORD-

Erforderlich. Die Größe dieser Struktur in Byte.

fMask

Typ: ULONG-

Eine Kombination aus einem oder mehreren der folgenden Werte, die den Inhalt und die Gültigkeit der anderen Strukturmember angeben:

hwnd

Typ: HWND-

Wahlfrei. Ein Handle für das Besitzerfenster, das verwendet wird, um alle Ui anzuzeigen und zu positionieren, die das System während der Ausführung dieser Funktion erzeugen kann.

lpVerb

Typ: LPCTSTR-

Eine Zeichenfolge, die als Verbbezeichnet wird, das die auszuführende Aktion angibt. Die Gruppe der verfügbaren Verben hängt von der jeweiligen Datei oder dem jeweiligen Ordner ab. Im Allgemeinen sind die im Kontextmenü eines Objekts verfügbaren Aktionen verfügbar. Dieser Parameter kann NULL-sein, in diesem Fall wird das Standardverb verwendet, falls verfügbar. Andernfalls wird das Verb "open" verwendet. Wenn kein Verb verfügbar ist, verwendet das System das erste Verb, das in der Registrierung aufgeführt ist. Wenn es keinen Grund gibt, die Aktion auf ein bestimmtes Verb zu beschränken, übergeben Sie NULL, um den berechneten Standardwert zu verwenden. Dies ist in einigen Fällen erforderlich, z. B. beim Angeben von SEE_MASK_FLAG_NO_UI und der Absicht, die Benutzeroberfläche "Öffnen mit" zu erstellen, wenn keine Apps installiert sind.

Die folgenden Verben werden häufig verwendet:

• bearbeiten: Startet einen Editor und öffnet das Dokument zur Bearbeitung. Wenn lpFile- keine Dokumentdatei ist, schlägt die Funktion fehl.
• erkunden sie: Durch die lpFile-angegebenen Ordner.
• finden: Initiiert eine Suche beginnend mit dem angegebenen Verzeichnis.
• öffnen sie: Öffnet die durch den parameter lpFile angegebene Datei. Die Datei kann eine ausführbare Datei, eine Dokumentdatei oder ein Ordner sein.
• openas: Startet eine Auswahl-UI, mit der der Benutzer eine App auswählen kann, mit der die durch den parameter lpFile angegebene Datei geöffnet werden soll.
• drucken: Druckt die dokumentdatei, die durch lpFile-angegeben wird. Wenn lpFile- keine Dokumentdatei ist, schlägt die Funktion fehl.
• Eigenschaften: Zeigt die Eigenschaften der Datei oder des Ordners an.
• runas: Startet eine Anwendung als Administrator. Die Benutzerkontensteuerung (User Account Control, UAC) fordert den Benutzer auf, der Anwendung mit erhöhten Rechten zuzustimmen oder die Anmeldeinformationen eines Administratorkontos einzugeben, mit dem die Anwendung ausgeführt wird.

lpFile

Typ: LPCTSTR-

Die Adresse einer mit Null beendeten Zeichenfolge, die den Namen der Datei oder des Objekts angibt, für die ShellExecuteEx- die durch den parameter lpVerb angegebene Aktion ausführt. Die systemregistrierungsverben, die von der ShellExecuteEx-Funktion unterstützt werden, umfassen "öffnen" für ausführbare Dateien und Dokumentdateien und "drucken" für Dokumentdateien, für die ein Druckhandler registriert wurde. Andere Anwendungen haben möglicherweise Shell-Verben über die Systemregistrierung hinzugefügt, z. B. "Wiedergeben" für .avi und .wav Dateien. Um ein Shell-Namespaceobjekt anzugeben, übergeben Sie den vollqualifizierten Analysenamen, und legen Sie das SEE_MASK_INVOKEIDLIST Flag im fMask--Parameter fest.

lpParameters

Typ: LPCTSTR-

Wahlfrei. Die Adresse einer mit Null beendeten Zeichenfolge, die die Anwendungsparameter enthält. Die Parameter müssen durch Leerzeichen getrennt werden. Wenn das lpFile-Element eine Dokumentdatei angibt, sollte lpParameters-NULL-sein.

lpDirectory

Typ: LPCTSTR-

Wahlfrei. Die Adresse einer mit Null beendeten Zeichenfolge, die den Namen des Arbeitsverzeichnisses angibt. Wenn dieses Mitglied NULL-ist, wird das aktuelle Verzeichnis als Arbeitsverzeichnis verwendet.

nShow

Typ: int

Erforderlich. Flags, die angeben, wie eine Anwendung angezeigt werden soll, wenn sie geöffnet wird; einer der SW_ Werte, die für die ShellExecute-Funktion aufgeführt sind. Wenn lpFile- eine Dokumentdatei angibt, wird das Flag einfach an die zugeordnete Anwendung übergeben. Es liegt an der Anwendung, zu entscheiden, wie sie behandelt werden soll.

hInstApp

Typ: HINSTANCE-

[out] Wenn SEE_MASK_NOCLOSEPROCESS festgelegt ist und der ShellExecuteEx-Aufruf erfolgreich ausgeführt wird, wird dieses Element auf einen Wert festgelegt, der größer als 32 ist. Wenn die Funktion fehlschlägt, wird sie auf einen SE_ERR_XXX Fehlerwert festgelegt, der die Ursache des Fehlers angibt. Obwohl hInstApp- zur Kompatibilität mit 16-Bit-Windows-Anwendungen als HINSTANCE deklariert wird, ist dies kein wahrer HINWEIS. Sie kann nur in eine int und im Vergleich zu 32 oder den folgenden SE_ERR_XXX Fehlercodes umgestellt werden.

lpIDList

Typ: LPVOID-

Die Adresse einer absoluten ITEMIDLIST- Struktur (PCIDLIST_ABSOLUTE), die eine Elementbezeichnerliste enthält, die die auszuführende Datei eindeutig identifiziert. Dieses Element wird ignoriert, wenn das fMask Member nicht SEE_MASK_IDLIST oder SEE_MASK_INVOKEIDLISTenthält.

lpClass

Typ: LPCTSTR-

Die Adresse einer mit Null beendeten Zeichenfolge, die eine der folgenden Werte angibt:

• Eine ProgId. Beispiel: "Paint.Picture".
• Ein URI-Protokollschema. Beispiel: "http".
• Eine Dateierweiterung. Beispiel: ".txt".
• Ein Registrierungspfad unter HKEY_CLASSES_ROOT, der einen Unterschlüssel benennt, der ein oder mehrere Shellverben enthält. Dieser Schlüssel verfügt über einen Unterschlüssel, der dem Shell-Verbregistrierungsschema entspricht, z. B. Shell-\Verbname.

Dieses Element wird ignoriert, wenn fMask- nicht SEE_MASK_CLASSNAMEenthält.

hkeyClass

Typ: HKEY-

Ein Handle für den Registrierungsschlüssel für den Dateityp. Die Zugriffsrechte für diesen Registrierungsschlüssel sollten auf KEY_READ festgelegt werden. Dieses Element wird ignoriert, wenn fMask- nicht SEE_MASK_CLASSKEYenthält.

dwHotKey

Typ: DWORD-

Eine Tastenkombination, die der Anwendung zugeordnet werden soll. Das Wort mit niedriger Reihenfolge ist der virtuelle Schlüsselcode, und das Hochreihenfolgenwort ist ein Modifizierer-Flag (HOTKEYF_). Eine Liste der Modifiziererkennzeichnungen finden Sie in der Beschreibung der WM_SETHOTKEY Nachricht. Dieses Element wird ignoriert, wenn fMask- nicht SEE_MASK_HOTKEYenthält.

DUMMYUNIONNAME

DUMMYUNIONNAME.hIcon

Typ: HANDLE

Ein Handle zum Symbol für den Dateityp. Dieses Element wird ignoriert, wenn fMask- nicht SEE_MASK_ICONenthält. Dieser Wert wird nur in Windows XP und früheren Versionen verwendet. Sie wird ab Windows Vista ignoriert.

DUMMYUNIONNAME.hMonitor

Typ: HANDLE

Ein Handle auf dem Monitor, auf dem das Dokument angezeigt werden soll. Dieses Element wird ignoriert, wenn fMask- nicht SEE_MASK_HMONITORenthält.

hProcess

Typ: HANDLE

Ein Handle für die neu gestartete Anwendung. Dieses Element wird beim Zurückgeben festgelegt und ist immer NULL-, es sei denn, fMask- auf SEE_MASK_NOCLOSEPROCESSfestgelegt ist. Selbst wenn fMask- auf SEE_MASK_NOCLOSEPROCESSfestgelegt ist, wird hProcess-NULL-, wenn kein Prozess gestartet wurde. Wenn beispielsweise ein dokument, das gestartet werden soll, eine URL ist und eine Instanz von Internet Explorer bereits ausgeführt wird, wird das Dokument angezeigt. Es wird kein neuer Prozess gestartet, und hProcess- wird NULL-.

Bemerkungen

Das flag SEE_MASK_NOASYNC muss angegeben werden, wenn der Threadaufruf ShellExecuteEx keine Meldungsschleife enthält oder der Thread oder Prozess bald nach ShellExecuteEx- beendet wird. Unter diesen Bedingungen steht der aufrufende Thread nicht zur Verfügung, um die DDE-Unterhaltung abzuschließen. Daher ist es wichtig, dass ShellExecuteEx die Unterhaltung abschließen, bevor die Steuerung an die aufrufende Anwendung zurückgegeben wird. Fehler beim Abschließen der Unterhaltung kann zu einem erfolglosen Start des Dokuments führen.

Wenn der aufrufende Thread über eine Meldungsschleife verfügt und nach dem Aufruf von ShellExecuteEx- einige Zeit vorhanden ist, ist das SEE_MASK_NOASYNC-Flag optional. Wenn das Flag ausgelassen wird, wird die Nachrichtenpumpe des aufrufenden Threads verwendet, um die DDE-Unterhaltung abzuschließen. Die aufrufende Anwendung erhält die Kontrolle früher wieder, da die DDE-Unterhaltung im Hintergrund abgeschlossen werden kann.

Um doppelte Anführungszeichen in lpParameterseinzuschließen, schließen Sie die einzelnen Markierungen wie im folgenden Beispiel in ein Anführungszeichenpaar ein.

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

In diesem Fall empfängt die Anwendung drei Parameter: An, Beispiel:und "an zitierten Text".

Anforderungen