3.2.4.2.26.4 FileScreenFlags (put) (Opnum 15)

The FileScreenFlags (put) sets the file screen flags of the object.

 [propput, id(FSRM_PROPERTY(FSRM_DISPID_FILESCREEN_BASE | 0x02))] HRESULT FileScreenFlags(
   [in] long fileScreenFlags
 );

fileScreenFlags: Contains the file screen flags for the object to use.

Return Values: The method MUST return zero on success, or a nonzero error code on failure.

Return value/code

Description

0x80070057

E_INVALIDARG

This code is returned for the following reasons:

Upon receiving this message, the server MUST validate parameters:

  • Verify that fileScreenFlags contains valid FsrmFileScreenFlags bitmask values, or that the value is 0.

If any validation fails, the server MUST terminate processing and return a nonzero error code.

The server MUST do one of the following or return a nonzero error code.

  • If fileScreenFlags contains the FsrmFileScreenFlags_Enforce bitmask, the server MUST fail any I/O that triggers a file screen event on this file screen's path.

  • If fileScreenFlags does not contain the FsrmFileScreenFlags_Enforce bitmask, the server MUST NOT fail an I/O that triggers a file screen event on this file screen's path.