FindFirstFileExFromAppW 関数 (fileapifromapp.h)

指定したものと一致する名前と属性を持つファイルまたはサブディレクトリをディレクトリで検索します。 この関数の動作は FindFirstFileEx と同じですが、この関数は ユニバーサル Windows プラットフォーム アプリ セキュリティ モデルに準拠しています。

構文

WINSTORAGEAPI HANDLE FindFirstFileExFromAppW(
  LPCWSTR            lpFileName,
  FINDEX_INFO_LEVELS fInfoLevelId,
  LPVOID             lpFindFileData,
  FINDEX_SEARCH_OPS  fSearchOp,
  LPVOID             lpSearchFilter,
  DWORD              dwAdditionalFlags
) noexcept;

パラメーター

lpFileName

ディレクトリまたはパス、およびファイル名。 ファイル名には、アスタリスク (*) や疑問符 (?) などのワイルドカード文字を含めることができます。

このパラメーターは NULL、無効な文字列 (たとえば、空の文字列や終端の null 文字がない文字列)、末尾の円記号 (\) で終わる値にすることはできません。

文字列がワイルドカード、ピリオド、またはディレクトリ名で終わる場合、ユーザーはルートとパス上のすべてのサブディレクトリにアクセスできる必要があります。

前もって "\\?\" を指定せずに MAX_PATH 制限からオプトアウトする方法の詳細については、「ファイル、パス 、および名前空間の名前付け 」の「パスの最大長の制限」セクションを参照してください。

fInfoLevelId

返されるデータの情報レベル。

このパラメーターは、 FINDEX_INFO_LEVELS 列挙値の 1 つです。

lpFindFileData

ファイル データを受信するバッファーへのポインター。

ポインター型は、 fInfoLevelId パラメーターで指定された情報のレベルによって決まります。

fSearchOp

ワイルドカード一致とは異なる、実行するフィルター処理の種類。

このパラメーターは、 FINDEX_SEARCH_OPS 列挙値の 1 つです。

lpSearchFilter

指定した fSearchOp に構造化された検索情報が必要な場合は、検索条件へのポインター。

現時点では、サポートされている fSearchOp 値のいずれも拡張検索情報を必要としません。 したがって、このポインターは NULL である必要があります。

dwAdditionalFlags

検索を制御する追加のフラグを指定します。

戻り値

関数が成功した場合、戻り値は FindNextFile または FindClose の後続の呼び出しで使用される検索ハンドルであり、 lpFindFileData パラメーターには最初に見つかったファイルまたはディレクトリに関する情報が含まれます。

関数が失敗するか、 lpFileName パラメーターの検索文字列からファイルを検索できない場合、戻り値は INVALID_HANDLE_VALUE され、 lpFindFileData の内容は不確定になります。 エラーの詳細情報を得るには、GetLastError 関数を呼び出します。

要件