Fbwf Class (Standard 8)

7/8/2014

Review the syntax, members, and examples of the Fbwf WMI provider class for Windows Embedded 8 Standard (Standard 8).

This class is used to get information about File-Based Write Filter (FBWF) configurations for both the current session and the next session, and to change general settings.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties.

Syntax

class Fbwf
{
  boolean Enabled;
  boolean NextEnabled;
};

Members

This class defines the following types of members:

Methods
Properties

Methods

This class defines the following methods.

Methods	Description
AddExclusion Method	Adds a file or directory to the file exclusion list.
CommitFile Method	Writes the cached file to the physical disk file.
ProtectVolume Method	Enables write protection for a specific volume.
RemoveExclusion Method	Removes a file or directory from the exclusion list.
RestoreFile Method	Resets the cached view of the specified file.
UnprotectVolume Method	Removes write protection for a specific volume and optionally removes the exclusion list.

Properties

This class defines the following properties.

Property	Data type	Qualifiers	Description
Enabled	Boolean	[Read]	Returns true if the FBWF is active in the current session; otherwise, returns false.
NextEnabled	Boolean	[Read, Write]	Specifies whether the FBWF is active in the next session.

Example

This example can be used to retrieve the FBWF configuration.

Windows PowerShell

$ComputerName="localhost"   # or "remote-machine-name"
$Namespace = "root\Microsoft\WriteFilters"
$Class = "Fbwf"

Write-Host "Retrieving Fbwf configuration..."

$Fbwf = Get-WmiObject `
   -ComputerName $ComputerName `
   -Namespace $Namespace `
   -Class $Class 
Write-Output $Fbwf | Format-List

VBScript

strComputer = "localhost"   ' or "remote-machine-name"
strNamespace = "\root\Microsoft\WriteFilters"
strClass = "Fbwf=@"

WScript.Echo "Retrieving Fbwf configuration..."

On Error Resume Next

Set Fbwf = GetObject("WINMGMTS:\\" & strComputer & strNamespace & ":" & strClass)

If Err.Number <> 0 Then
   WScript.Echo "Method exited with error code: 0x" & Hex(Err.Number)
   Wscript.Echo Err.Source & " - " & Err.Description
   WScript.Quit(1)
End If

For Each Prop In Fbwf.Properties_
   WScript.Echo Prop.Name & ":" & Prop.Value
Next

Requirements

Architecture	x64, x86
MOF	FBWFProvider.mof
Supported Clients	Windows XP Embedded SP3 Windows Embedded Standard 2009 Windows Embedded Standard 7 SP1 Windows Embedded 8 Standard WEPOS 1.1 SP3 POSReady 2009 Windows Embedded POSReady 7 Windows Fundamentals for Legacy PCs 7
WMI Namespace	root\Microsoft\WriteFilters
WMI Provider	FBWFProvider