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:
The fileScreenFlags parameter is NULL.
The fileScreenFlags parameter contains invalid FsrmFileScreenFlags (section 2.2.1.2.2) bitmask values.
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.