GetFileAttributesTransactedA 関数 (winbase.h)

[アーティクル]
06/02/2023

[Microsoft では、開発者がアプリケーションのニーズを達成するために代替手段を利用することを強くお勧めします。 TxF が開発された多くのシナリオは、よりシンプルで簡単に利用できる手法によって実現できます。さらに、将来のバージョンの Microsoft Windows では TxF を使用できない場合があります。詳細と TxF の代替方法については、「トランザクション NTFS を使用するための代替手段」を参照してください。

トランザクション操作として、指定されたファイルまたはディレクトリのファイルシステム属性を取得します。

構文

BOOL GetFileAttributesTransactedA(
  [in]  LPCSTR                 lpFileName,
  [in]  GET_FILEEX_INFO_LEVELS fInfoLevelId,
  [out] LPVOID                 lpFileInformation,
  [in]  HANDLE                 hTransaction
);

パラメーター

[in] lpFileName

ファイルまたはディレクトリの名前。

既定では、名前はMAX_PATH文字に制限されています。この制限を 32,767 文字のワイド文字に拡張するには、パスの先頭に "\\?\" を付加します。詳細については、「ファイル、パス、および名前空間の名前付け」を参照してください。

ヒント

Windows 10 バージョン 1607 以降では、"\\?\" を前もって指定しなくても、MAX_PATHの制限を削除するようにオプトインできます。詳細については、「名前付けファイル、パス、および名前空間」の「パスの最大長制限」セクションを参照してください。

ファイルまたはディレクトリは、ローカルコンピューター上に存在する必要があります。それ以外の場合、関数は失敗し、最後のエラーコードは ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE に設定されます。

[in] fInfoLevelId

取得する属性情報のレベル。

このパラメーターには、 GET_FILEEX_INFO_LEVELS 列挙の次の値を指定できます。

値	説明
GetFileExInfoStandard	lpFileInformation パラメーターは、WIN32_FILE_ATTRIBUTE_DATA構造体です。

[out] lpFileInformation

属性情報を取得するバッファーへのポインター。

このバッファーに格納される属性情報の種類は、fInfoLevelId の値によって決まります。 fInfoLevelId パラメーターが GetFileExInfoStandard の場合、このパラメーターは WIN32_FILE_ATTRIBUTE_DATA 構造体を指します

[in] hTransaction

トランザクションへのハンドル。このハンドルは、 CreateTransaction 関数によって返されます。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合、戻り値はゼロ (0) になります。詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

マウントされたフォルダーであるディレクトリで GetFileAttributesTransacted が呼び出されると、マウントされたフォルダーがディレクトリに関連付けられているボリューム内のルートディレクトリの属性ではなく、ディレクトリの属性が返されます。関連付けられたボリュームのファイル属性を取得するには、 GetVolumeNameForVolumeMountPoint を呼び出して、関連付けられたボリュームの名前を取得します。次に、 GetFileAttributesTransacted の呼び出しで結果の名前を使用します。結果は、関連付けられたボリューム上のルートディレクトリの属性です。

Windows 8とWindows Server 2012では、この関数は次のテクノロジでサポートされています。

テクノロジ	サポートされています
サーバーメッセージブロック (SMB) 3.0 プロトコル	いいえ
SMB 3.0 Transparent Failover (TFO)	いいえ
スケールアウトファイル共有を含む SMB 3.0 (SO)	いいえ
クラスター共有ボリュームファイルシステム (CsvFS)	いいえ
Resilient File System (ReFS)	いいえ

SMB 3.0 では TxF はサポートされていません。

シンボリックリンク: パスがシンボリックリンクを指している場合、関数はシンボリックリンクの属性を返します。

Transacted Operations

ファイルがトランザクションで変更のために開かれている場合、トランザクションがコミットされるまで、他のスレッドは変更のためにファイルを開くできません。逆に、トランザクションの外部でファイルを変更するために開いている場合、トランザクションされていないハンドルが閉じられるまで、トランザクションスレッドはファイルを開いて変更を行うことができません。トランザクションされていないスレッドに、ファイルを変更するためのハンドルが開かれている場合、そのファイルに対する GetFileAttributesTransacted の呼び出しは 、ERROR_TRANSACTIONAL_CONFLICT エラーで失敗します。

注意

winbase.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetFileAttributesTransacted を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイルエラーまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件


サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	winbase.h (Windows.h を含む)
Library	Kernel32.lib
[DLL]	Kernel32.dll

GetFileAttributesTransactedA 関数 (winbase.h)

構文

パラメーター

戻り値

解説

Transacted Operations

要件

関連項目

フィードバック

フィードバック

その他のリソース