[MS-VDS]: Virtual Disk Service (VDS) Protocol Specification

HRESULT FormatPartitionEx2([in] ULONGLONG ullOffset,[in, unique, string] LPWSTR pwszFileSystemTypeName,[in] USHORT usFileSystemRevision,[in] ULONG ulDesiredUnitAllocationSize,[in, unique, string] LPWSTR pwszLabel,[in] DWORD Options,[out] IVdsAsync** ppAsync);ullOffset: The byte offset of the partition from the beginning of the disk. This MUST be the offsetat the start of a partition.pwszFileSystemTypeName: A null-terminated Unicode string that contains the name of the filesystem with which to format the partition.usFileSystemRevision: A 16-bit, binary-coded decimal number that indicates the revision of thefile system, if any. The first two (most significant) digits (8-bits) indicate the major revisionwhile the last two (least significant) digits (8-bits) indicate the minor revision (for example,0x0250 represents version 2.50).ulDesiredUnitAllocationSize: The size, in bytes, of the allocation unit for the file system. Thevalue MUST be a power of 2. If the value is 0, a default allocation unit determined by the filesystem type is used. The allocation unit range is file system-dependent.pwszLabel: The null-terminated Unicode string to assign to the new file system. The maximumlabel size is file system-dependent.Options: The combination of any values, by using a bitwise OR operator, that are defined in theVDS_FORMAT_OPTION_FLAGS enumeration.ppAsync: A pointer to an IVdsAsync interface that, if the operation is successfully completed,receives the IVdsAsync interface pointer to monitor and control this operation. Callers MUSTrelease the interface when they are done with it.Return Values: The method MUST return zero or a non-error HRESULT (as specified in [MS-ERREF]) to indicate success, or return an implementation-specific nonzero error code toindicate failure. For the HRESULT values predefined by the Virtual Disk Service RemoteProtocol, see section 2.2.3.Note This method is not valid on CD/DVD or super floppy devices. These devices do notsupport partition tables.When the server receives this message, it MUST validate the following parameters:•Verify that ppAsync is not NULL.•Verify that the partition at offset ullOffset is an OEM, ESP, recovery, or unknown partition.The server MUST perform the following:•Create a new async object implementing the IVdsAsync interface with an output type ofVDS_ASYNCOUT_FORMAT and set the pointer ppAsync references to the interface.•Return an HRESULT indicating failure or success. Any errors encountered up through this point inprocessing the FormatPartitionEx2 operation are returned in this HRESULT.[MS-VDS] — v20110610Virtual Disk Service (VDS) Protocol SpecificationCopyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011232 / 360