RemoveDirectoryTransactedW 関数 (winbase.h)

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

トランザクション操作として既存のディレクトリを削除します。

構文

BOOL RemoveDirectoryTransactedW(
  [in] LPCWSTR lpPathName,
  [in] HANDLE  hTransaction
);

パラメーター

[in] lpPathName

削除するディレクトリのパス。 パスは空のディレクトリを指定する必要があり、呼び出し元のプロセスはディレクトリへの削除アクセス権を持っている必要があります。

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

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

[in] hTransaction

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

戻り値

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

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

RemoveDirectoryTransacted 関数は、閉じるとディレクトリに削除のマークを付けます。 したがって、ディレクトリへの最後のハンドルが閉じられるまで、ディレクトリは削除されません。

RemoveDirectory は 、ターゲットの内容が空でない場合でも、ディレクトリ ジャンクションを削除します。関数は、ターゲット オブジェクトの状態に関係なく、ディレクトリ ジャンクションを削除します。

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

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

要件

関連項目

CreateDirectoryTransacted

ディレクトリの作成と削除

ディレクトリ管理の関数

トランザクション NTFS