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

•Allocate a buffer to hold the volume GUID path names associated with the volume, and initializepwszPathArray with the address of the buffer.•Populate the output buffer with the volume GUID path names. Set the value ofpulNumberOfPaths to the number of the volume GUID path names being returned.•Return an HRESULT indicating failure or success.3.4.5.2.34.2 IVdsVolumeMF3::FormatEx2 (Opnum 4)The FormatEx2 method formats a file system on a volume.HRESULT FormatEx2([in, unique, string] LPWSTR pwszFileSystemTypeName,[in] USHORT usFileSystemRevision,[in] ULONG ulDesiredUnitAllocationSize,[in, unique, string] LPWSTR pwszLabel,[in] DWORD Options,[out] IVdsAsync** ppAsync);pwszFileSystemTypeName: A null-terminated Unicode string that contains the name of the filesystems to format the volume with.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 revision,and the last two (least significant) digits (8 bits) indicate the minor revision. For example,0x0250 represents revision 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 that is determined bythe file system type is used. The allocation unit range is file system-dependent.pwszLabel: A 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 to monitor and control this operation. Callers MUST releasethe 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.When the server receives this message, it MUST validate the following parameter:•Verify that ppAsync is not NULL.•Create a new async object that implements the IVdsAsync interface with an output type ofVDS_ASYNCOUT_FORMAT, and then set the pointer that ppAsync references to the interface.[MS-VDS] — v20110610Virtual Disk Service (VDS) Protocol SpecificationCopyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011260 / 360