SaferiIsExecutableFileType 関数 (winsafer.h)

  • [アーティクル]

SaferiIsExecutableFileType 関数は、指定したファイルが実行可能ファイルであるかどうかを判断します。 アプリケーションでは、この関数を使用して、ファイルが実行可能ファイルであるかどうかを判断します。ファイルが実行可能な場合は、信頼できないコードの呼び出しを防ぐためにセキュリティ上の予防措置を講じることができます。

構文

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

パラメーター

[in] szFullPathname

ファイル名の null で終わる Unicode 文字列へのポインター。 ファイル名拡張子のみが評価されるため、パスは省略可能です。 ファイル名拡張子の評価では、大文字と小文字は区別されません。 このパラメーターは NULL または空の文字列にすることはできません。指定されたファイルにはファイル名拡張子を含める必要があります。

[in] bFromShellExecute

ファイルの種類を評価するために、ファイル .exe 実行可能ファイルとして扱われるかどうかを決定するブール値。 評価から .exe ファイルを省略する場合は TRUE 、含める場合は FALSE に設定します。

戻り値

関数がファイル名の拡張子を実行可能ファイルの種類として正常に認識した場合、戻り値は TRUE になります。

関数が失敗した場合、または szFullPath が実行可能でない拡張子を持つファイル名を識別した場合、関数は FALSE を返します。

注釈

次のファイル名拡張子は、実行可能ファイルの種類の例です。 これですべてではありません。

  • .bat
  • .cmd
  • .com
  • .exe
  • .js
  • .lnk
  • .pif
  • .pl
  • .shs
  • .url
  • .vbs
セキュリティ ポリシー Microsoft 管理コンソール (MMC) スナップイン (Secpol.msc) は、実行可能ファイルの種類と見なされる拡張機能を制御します。

実行可能ファイルの種類と見なされる拡張機能を表示または変更するには

  1. Secpol.msc を実行します。
  2. [ ソフトウェア制限ポリシー] を展開し、[ 指定されたファイルの種類] をダブルクリックします。
メモ[指定されたファイルの種類] プロパティ ページを表示するには、[ソフトウェア制限ポリシー] ノードを作成する必要がある場合があります。 [ソフトウェア制限ポリシー] ノードを作成するには、[ソフトウェア制限ポリシー] を展開したときに表示される手順に従います。
 

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー winsafer.h
Library Advapi32.lib
[DLL] Advapi32.dll
API セット ext-ms-win-advapi32-safer-l1-1-0 (Windows 8で導入)