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

If the volume is associated with a removable device and there is no media present, then thismethod MUST return VDS_E_NO_MEDIA.If the volume is in the OFFLINE state, then this method SHOULD returnVDS_E_VOLUME_NOT_ONLINE.If the user level access granted to the thread that makes this method call does not have sufficientprivileges, then this method MUST convert the Win32 error ERROR_ACCESS_DENIED to an HRESULTand return the result to the calling application.3.4.5.2.32.2 IVdsVolumeMF::Format (Opnum 4)The Format method formats a file system on the current volume.HRESULT Format([in] VDS_FILE_SYSTEM_TYPE type,[in, string] WCHAR* pwszLabel,[in] DWORD dwUnitAllocationSize,[in] long bForce,[in] long bQuickFormat,[in] long bEnableCompression,[out] IVdsAsync** ppAsync);type: A file system type that is enumerated by VDS_FILE_SYSTEM_TYPE. Clients that formatby using file systems that are not enumerated by VDS_FILE_SYSTEM_TYPE may use theIVdsVolumeMF2::FormatEx method.pwszLabel: A null-terminated Unicode label to assign to the new file system. The maximumlabel size is file system-dependent.dwUnitAllocationSize: The size, in bytes, of the allocation unit for the file system. The valueMUST be a power of 2. The allocation unit range is file system-dependent.bForce: A Boolean that determines whether the format is forced, even if the volume is in use.bQuickFormat: A Boolean that determines whether a file system is quick format. A quick formatdoes not verify each sector on the volume.bEnableCompression: A Boolean that determines whether a file system is created withcompression enabled.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.[MS-VDS] — v20110610Virtual Disk Service (VDS) Protocol SpecificationCopyright © 2011 Microsoft Corporation.Release: Friday, June 10, 2011248 / 360