Windows Dev Center

IFsrmFileGroup::NonMembers property

[This method is supported for compatibility but it's recommended to use the FSRM WMI Classes to manage FSRM. Please see the MSFT_FSRMFileGroup class.]

Retrieves or sets the filename patterns that determine the files that are excluded from the file group.

This property is read/write.

Syntax


HRESULT put_NonMembers(
  [in]  IFsrmMutableCollection *nonMembers
);

HRESULT get_NonMembers(
  [out] IFsrmMutableCollection **nonMembers
);

Property value

An IFsrmMutableCollection interface that contains a collection of filename patterns.

Each item of the collection is a VARIANT of type VT_BSTR. Set the bstrVal member to the filename pattern. The pattern is limited to 260 characters. The pattern cannot contain quotation marks, slash marks, backslashes, or colons.

Previous patterns are overwritten.

Error codes

The method returns the following return values.

NameMeaning
S_OK

Success.

E_INVALIDARG

Returns this value for the following reasons:

  • The nonMembers parameter is NULL.
  • The nonMembers parameter contains non-valid characters.
  • The variant is not of type VT_BSTR.
FSRM_E_INVALID_TEXT

One of the specified non-members contains an empty string.

Remarks

A filename pattern is a string expression that defines a set of filenames. The expression may contain the following wildcard characters: "*" and "?". The "*" wildcard matches 0 or more characters and the "?" wildcard matches exactly 1 character. For example, the file name "example.cpp" matches the pattern "e*.cpp", but not "e?.cpp". The filename "ex.cpp" would match both patterns. Note that when the filename pattern is used to compare against a specific filename, the pattern match is case-insensitive.

You use the property to allow file patterns that would otherwise be blocked by the Members property. For example, if Members property uses "*.mp*" to block mp3 files, you could set this property to "*.mpp" to allow "*.mpp" files.

Examples

For an example, see Creating File Groups to Specify the Files to Restrict.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008

Header

FsrmScreen.h

DLL

SrmSvc.dll

IID

IID_IFsrmFileGroup is defined as 8dd04909-0e34-4d55-afaa-89e1f1a1bbb9

See also

IFsrmFileGroup

 

 

Show:
© 2015 Microsoft