22.214.171.124.29.7 GetFileScreenException (Opnum 13)
[id(FSRM_DISPID_FILESCREEN_MANAGER | 0x05)] HRESULT GetFileScreenException( [in] BSTR path, [out, retval] IFsrmFileScreenException** fileScreenException );
path: Contains the path of the file screen exception to return.
fileScreenException: Pointer to an IFsrmFileScreenException interface pointer (section 126.96.36.199.28) that upon completion contains a pointer to the file screen exception for the specified path. The caller MUST release the file screen exception when it is done with it.
Return Values: The method MUST return zero on success, or a nonzero error code on failure.
A file screen exception has not been applied to the specified directory.
The file screen exception for the specified path could not be found.
The content of the path parameter exceeds the maximum length of 260 characters.
This code is returned for the following reasons:
The path parameter is NULL.
The fileScreenException parameter is NULL.
Upon receiving this message, the server MUST validate parameters:
Verify that path is not NULL.
Verify that fileScreenException is not NULL.
If any validation fails, the server MUST terminate processing and return a nonzero error code.
Upon successful validation of parameters, the server MUST perform the following actions or return a nonzero error code.
Populate its configuration data from the Persisted File Screen Exception (section 188.8.131.52.2.1) in the List of Persisted File Screen Exceptions with the specified path.
Set fileScreenException to the IFsrmFileScreenException interface pointer of the newly created Non-Persisted File Screen Exception Instance.
If a file screen exception does not exist for the specified path, the server MUST return FSRM_E_NOT_FOUND.