Share via


FbwfUnprotectVolume

5/10/2007

Removes write protection on the specified volume.

Syntax

ULONG FbwfUnprotectVolume(
   PWCHAR volume,
   ULONG removeExclusions
}

Parameters

  • volume
    [in] NULL terminated wide string to the name of the volume on which write filtering will be removed.
  • removeExclusions
    [in] Boolean value. If true, the exclusion list for this volume will be cleared.

Return Value

Return value Description

NO_ERROR

The operation completed successfully.

ERROR_INVALID_DRIVE

The specified volume is valid but does not exist or is not protected.

ERROR_INVALID_FUNCTION

The filter is not enabled for the next session.

ERROR_INVALID_PARAMETER

If the parameter volume is NULL

Remarks

This change will not take effect until the next session.

If removeExclusions is false, the FBWF will preserve the exclusion list for the specified volume. If FbwfProtectVolume is later called for the same volume, the same exclusion list will be in effect.

Requirements

OS Versions: Windows XP Embedded, WEPOS.

Header: fbwfapi.h.

Link Library: fbwflib.lib.

See Also

Reference

FbwfEnableFilter
FbwfProtectVolume
FbwfGetVolumeList
FbwfIsVolumeProtected

Concepts

FBWF API