3.2.4.2.27.7 ApplyTemplate (Opnum 23)

The ApplyTemplate method applies the properties of the specified file screen template to this file screen object.

 [id(FSRM_DISPID_FILESCREEN | 0x01)] HRESULT ApplyTemplate(
   [in] BSTR fileScreenTemplateName
 );

fileScreenTemplateName: Contains the name of the file screen template whose properties are to be applied to this file screen object. The maximum length of this string MUST be 4,000.

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

Return value/code

Description

0x80045304

FSRM_E_NOT_FOUND

The specified template could not be found.

0x80045308

FSRM_E_INVALID_NAME

The specified name in the fileScreenTemplateName parameter is empty.

0x8004530D

FSRM_E_OUT_OF_RANGE

The content of the fileScreenTemplateName parameter exceeds the maximum length of 4,000 characters.

0x80070057

E_INVALIDARG

The fileScreenTemplateName parameter is NULL.

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

  • If no file screen template with the specified name exists, the server MUST return FSRM_E_NOT_FOUND.

  • If the file screen template does exist, the server MUST apply all settings from the specified template to this file screen object.