Share via


EwfMgrDisable (Standard 8)

7/8/2014

Review the use, syntax, parameters, and return values of the EwfMgrDisable function of the EWF API in Windows Embedded 8 Standard (Standard 8).

This function disables a currently enabled overlay on the specified EWF-protected volume.

Syntax

BOOL EwfMgrDisable(
  HANDLE hDevice,
  BOOL fCommit
);

Parameters

  • hDevice
    [in] Handle to the EWF-protected volume.
  • fCommit
    [in] If TRUE, the current overlay is committed before the protection is disabled. If FALSE, all overlays are discarded and protection is disabled.

Return Value

Returns TRUE if successful; otherwise, returns FALSE. Call GetLastError for extended error information.

Remarks

The overlay is disabled on the next restart.

This function is supported on both disk and RAM overlays. However, on a RAM overlay that does not have an associated EWF overlay store keeping track of its protection settings (that is, registry-described RAM overlays), the fCommit flag must be set to TRUE, or the disable fails.

Example

The DoEwfDisable function that is included in EWF API Code Sample (Sample.cpp) shows you how to use the EwfMgrDisable function.

Requirements

Header

ewfapi.h

Library

ewfapi.lib

See Also

Reference

EwfMgrEnable

Concepts

EWF API Functions