Share via


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
DeduplicationProvider.mof
DLL
DdpWmi.dll

See also

MSFT_DedupVolume

MSFT_DedupVolume::Disable