IFsrmFileScreenManager::CreateFileScreenException method

Creates a file screen exception object.

Syntax


HRESULT CreateFileScreenException(
  [in]   BSTR path,
  [out]  IFsrmFileScreenException **fileScreenException
);

Parameters

path [in]

The local directory path to which the file screen exception applies. The path is limited to 260 characters.

fileScreenException [out]

An IFsrmFileScreenException interface of the newly created file screen exception. To add the exception to FSRM, call IFsrmFileScreenException::Commit method.

Return value

The method returns the following return values.

Return codeDescription
S_OK

Success

E_INVALIDARG

The fileScreenException parameter cannot be NULL.

FSRM_E_INVALID_PATH

The path cannot be empty or NULL. Also returned if the path is not valid.

FSRM_E_ALREADY_EXISTS

A file screen already exists for the specified directory.

 

Remarks

You can use the exception to allow files to be saved in a directory when a file screen would otherwise prevent it. For example, if P:\directory contains a file screen that blocks *.mp3, you could create an exception that allows MP3 files on P:\directory\subdirectory.

Examples

For an example, see Defining a File Screen Exception.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008

Header

FsrmScreen.h

DLL

SrmSvc.dll

IID

IID_IFsrmFileScreenManager is defined as ff4fa04e-5a94-4bda-a3a0-d5b4d3c52eba

See also

IFsrmFileScreenManager
FsrmFileScreenManager

 

 

Show:
© 2014 Microsoft. All rights reserved.