Skip to content

Latest commit

 

History

History
103 lines (80 loc) · 3.49 KB

ni-winioctl-fsctl_txfs_create_miniversion.md

File metadata and controls

103 lines (80 loc) · 3.49 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist f1_keywords dev_langs topic_type api_type api_location api_name
NI:winioctl.FSCTL_TXFS_CREATE_MINIVERSION
FSCTL_TXFS_CREATE_MINIVERSION
Creates a new miniversion for the specified file. Miniversions allow you to refer to a snapshot of the file during a transaction. Miniversions are discarded when a transaction is committed or rolled back.
FSCTL_TXFS_CREATE_MINIVERSION
FSCTL_TXFS_CREATE_MINIVERSION control
FSCTL_TXFS_CREATE_MINIVERSION control code [Files]
fs.fsctl_txfs_create_miniversion
winioctl/FSCTL_TXFS_CREATE_MINIVERSION
fs\fsctl_txfs_create_miniversion.htm
fs
3d12b149-ab34-46c4-89fc-8ddc12a81fa0
12/05/2018
FSCTL_TXFS_CREATE_MINIVERSION, FSCTL_TXFS_CREATE_MINIVERSION control, FSCTL_TXFS_CREATE_MINIVERSION control code [Files], fs.fsctl_txfs_create_miniversion, winioctl/FSCTL_TXFS_CREATE_MINIVERSION
winioctl.h
Windows.h
Windows
Windows Vista [desktop apps only]
Windows Server 2008 [desktop apps only]
Windows
FSCTL_TXFS_CREATE_MINIVERSION
winioctl/FSCTL_TXFS_CREATE_MINIVERSION
c++
APIRef
kbSyntax
HeaderDef
WinIoCtl.h
FSCTL_TXFS_CREATE_MINIVERSION

FSCTL_TXFS_CREATE_MINIVERSION IOCTL

-description

Note

Microsoft strongly recommends developers utilize alternative means to achieve your application’s needs. Many scenarios that TxF was developed for can be achieved through simpler and more readily available techniques. Furthermore, TxF may not be available in future versions of Microsoft Windows. For more information, and alternatives to TxF, please see Alternatives to using Transactional NTFS.

Creates a new miniversion for the specified file. Miniversions allow you to refer to a snapshot of the file during a transaction. Miniversions are discarded when a transaction is committed or rolled back.

BOOL DeviceIoControl(
  (HANDLE) hDevice,                 // handle to device
  FSCTL_TXFS_CREATE_MINIVERSION,    // dwIoControlCode
  NULL,                             // lpInBuffer
  0,                                // nInBufferSize
  (LPVOID) lpOutBuffer,             // output buffer
  (DWORD) nOutBufferSize,           // size of output buffer
  (LPDWORD) lpBytesReturned,        // number of bytes returned
  (LPOVERLAPPED) lpOverlapped       // OVERLAPPED structure
);

-ioctlparameters

-input-buffer

-input-buffer-length

-output-buffer

-output-buffer-length

-in-out-buffer

-inout-buffer-length

-status-block

Irp->IoStatus.Status is set to STATUS_SUCCESS if the request is successful.

Otherwise, Status to the appropriate error condition as a NTSTATUS code.

For more information, see NTSTATUS Values.

-remarks

FSCTL_TXFS_CREATE_MINIVERSION is a synchronous operation.

If you attempt to create a miniversion in a non-active transaction, ERROR_INVALID_TRANSACTION is returned.

ReFS:  This code is not supported.

-see-also