<div class="content"><p>The CreateAction method creates an action for this file
screen object.</p><dl>
<dd>
<div><pre> [id(FSRM_DISPID_FILESCREEN_BASE | 0x01)] HRESULT CreateAction(
   [in] FsrmActionType actionType,
   [out, retval] IFsrmAction** action
 );
</pre></div>
</dd></dl><p><b>actionType: </b>Contains the type of action to be
created.</p><p><b>action: </b>Pointer to an <b>IFsrmAction</b>
interface pointer (section <a href="8e93ed78-6809-4ee1-a98b-f3dcdc41ae71" data-linktype="relative-path">3.2.4.2.4</a>)
that upon completion points to the newly created action. A caller MUST release
the object received when the caller is done with it.</p><p><b>Return Values: </b>The method MUST return zero on
success, or a nonzero error code on failure.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Return value/code</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>
  <p>0x80045303</p>
  <p>FSRM_E_ALREADY_EXISTS</p>
  </td>
  <td>
  <p>The object already exists.</p>
  </td>
 </tr><tr>
  <td>
  <p>0x80070057</p>
  <p>E_INVALIDARG</p>
  </td>
  <td>
  <p>This code is returned for the following reasons:</p>
  <ul><li><p><span><span>  
  </span></span><span>The <i>action</i> parameter is
  NULL.</span></p>
  </li><li><p><span><span>  
  </span></span><span>The <i>actionType</i> parameter
  is not a valid type. If <i>actionType</i> is FsrmActionType_Unknown, the
  parameter MUST be considered an invalid value.</span></p>
  </li></ul></td>
 </tr></tbody></table>
</dd></dl><p>Upon receiving this message, the server MUST validate
parameters:</p><ul><li><p><span><span> 
</span></span>Verify that <i>actionType</i> is a valid <a href="0399ffcc-f04b-4dd9-bde7-c336e58eb8d4" data-linktype="relative-path">FsrmActionType (section 2.2.1.2.9)</a>.
If the <i>actionType</i> is <b>FsrmActionType_Unknown</b>, the parameter MUST
be considered an invalid value.</p>
</li><li><p><span><span> 
</span></span>Verify that <i>action</i> is not NULL.</p>
</li></ul><p>If any validation fails, the server MUST terminate
processing and return a nonzero error code.</p><p>The server MUST create a new <i>action</i> object of the
specified type and set action to the <b>IFsrmAction</b> interface of the newly
created <i>action</i>.</p></div>