SaferiIsExecutableFileType-Funktion (winsafer.h)

Die SaferiIsExecutableFileType-Funktion bestimmt, ob eine angegebene Datei eine ausführbare Datei ist. Anwendungen verwenden diese Funktion, um zu bestimmen, ob es sich bei einer Datei um eine ausführbare Datei handelt. Wenn dies der Fall ist, kann die Anwendung Sicherheitsvorkehrungen treffen, um zu verhindern, dass nicht vertrauenswürdiger Code aufgerufen wird.

Syntax

BOOL SaferiIsExecutableFileType(
  [in] LPCWSTR szFullPathname,
  [in] BOOLEAN bFromShellExecute
);

Parameter

[in] szFullPathname

Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung für den Namen der Datei. Der Pfad ist optional, da nur die Dateinamenerweiterung ausgewertet wird. Bei der Auswertung der Dateinamenerweiterung wird die Groß-/Kleinschreibung nicht beachtet. Dieser Parameter darf nicht NULL oder eine leere Zeichenfolge sein, und die angegebene Datei muss eine Dateinamenerweiterung enthalten.

[in] bFromShellExecute

Boolescher Wert, der bestimmt, ob .exe Dateien für die Dateitypauswertung als ausführbare Dateien behandelt werden. Legen Sie diesen Wert auf TRUE fest, um .exe Dateien aus der Auswertung auszulassen, oder auf FALSE , um sie einzuschließen.

Rückgabewert

Wenn die Funktion die Erweiterung des Dateinamens erfolgreich als ausführbaren Dateityp erkennt, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt oder szFullPath einen Dateinamen mit einer nicht ausführenden Erweiterung identifiziert, gibt die Funktion FALSE zurück.

Hinweise

Die folgenden Dateinamenerweiterungen sind Beispiele für ausführbare Dateitypen. Dies ist keine vollständige Liste.

  • .bat
  • .cmd
  • .com
  • .exe
  • .js
  • .lnk
  • .pif
  • .pl
  • .shs
  • .url
  • .vbs
Das Sicherheitsrichtlinien-Snap-In Microsoft Management Console (MMC) (Secpol.msc) steuert, welche Erweiterungen als ausführbare Dateitypen betrachtet werden.

So zeigen Sie die Erweiterungen an, die als ausführbare Dateitypen gelten

  1. Führen Sie Secpol.msc aus.
  2. Erweitern Sie Softwareeinschränkungsrichtlinien, und doppelklicken Sie dann auf Festgelegte Dateitypen.
Hinweis Um die Eigenschaftenseite Festgelegte Dateitypen anzuzeigen, müssen Sie möglicherweise den Knoten Softwareeinschränkungsrichtlinien erstellen. Befolgen Sie zum Erstellen des Knotens Softwareeinschränkungsrichtlinien die Anweisungen, die beim Erweitern von Softwareeinschränkungsrichtlinien angezeigt werden.
 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winsafer.h
Bibliothek Advapi32.lib
DLL Advapi32.dll
APIs ext-ms-win-advapi32-safer-l1-1-0 (eingeführt in Windows 8)