Enable method of the MSFT_DedupVolume class
Enables deduplication on the specified volumes by using default settings.
Syntax
uint32 Enable(
[in] string Volume[],
[in] boolean DataAccess,
[in] uint32 UsageType,
[out] MSFT_DedupVolume DedupVolume[]
);
Parameters
-
Volume [in]
-
A list of file system volumes for which to enable data deduplication. Volumes can be specified by drive letter (for example, D:) or volume GUID path. A volume GUID path is a string of the form "\\?\Volume{GUID}\" where GUID is a GUID that identifies the volume.
-
DataAccess [in]
-
If True, grants data access to deduplicated files on the volume to be enabled.
-
UsageType [in]
-
The type of data to store on the volume.
Windows Server 2012: This parameter is not supported until Windows Server 2012 R2.
The possible values are:
-
Default (1)
-
General purpose files shares. This is the default value.
-
HyperV (2)
-
Hyper-V storage.
-
Backup (3)
-
Backup storage.
Windows Server 2012 R2 and Windows Server 2012: This value is not supported before Windows Server 2016.
DedupVolume [out]
Array of references to the enabled volumes.
Return value
This method returns either a Windows Management Instrumentation (WMI) return code or a system error code.
Remarks
The MSFT_DedupVolume object references that are returned in the DedupVolume parameter can be used to customize the data deduplication settings.
Deduplication is disabled by default.
Certain volumes are not supported for data deduplication such as any volume that is not NTFS or any volume that is smaller than 100 MB. If you attempt to enable data deduplication for unsupported volumes, the call fails.
Examples
For an example that uses the Enable method, please see Data deduplication backup and restore sample.
Requirements
Minimum supported client |
None supported |
Minimum supported server |
Windows Server 2012 |
Namespace |
Root\Microsoft\Windows\Deduplication |
MOF |
|
DLL |
|