<div class="content" name="BackupOpenFile" uuid="f5fc08ea-2f9f-438d-93d2-4f8e6813df46"><p>The BackupOpenFile method opens a file for backup.</p><dl>
<dd>
<div><pre> HRESULT BackupOpenFile(
   [in, string, unique] wchar_t const* pwszPath,
   [out] unsigned hyper* pliLength
 );
</pre></div>
</dd></dl><p><b>pwszPath: </b>A null-terminated UNICODE string
that specifies the path to the targeted file. The file name MUST be <span><a href="c6451297-197d-4b4b-b786-3f3187b67b8f#gt_c9507dca-291d-4fd6-9cba-a9ee7da8c908" data-linktype="relative-path">UNC</a></span>
form, for example: &#34;\\server\sharepoint\...path...\filename.ext&#34;.</p><p><b>pliLength: </b>A pointer to a signed 64-bit
integer that receives the size, in bytes, of the targeted file.</p><p>The <span><a href="c6451297-197d-4b4b-b786-3f3187b67b8f#gt_c925d5d7-a442-4ba4-9586-5f94ccec847a" data-linktype="relative-path">CA</a></span> server MUST
enforce the sequencing rules for BackupOpenFile as specified in section <span><a href="e37640b4-b2e1-4bac-89d2-61fc5a5e6c1d" data-linktype="relative-path">3.1.4.1.18</a></span>.<a id="Appendix_A_Target_64"></a><a aria-label="Product behavior note 64" href="5f06c74c-1a29-4fdf-b8dd-ae3300d1b90d#Appendix_A_64" data-linktype="relative-path">&lt;64&gt;</a></p><p>The CA server MUST apply the following processing rules:</p><ul><li><p><span><span> 
</span></span>If Config_CA_Interface_Flags contains the value
IF_NOREMOTEICERTADMINBACKUP, the server SHOULD return an error.<a id="Appendix_A_Target_65"></a><a aria-label="Product behavior note 65" href="5f06c74c-1a29-4fdf-b8dd-ae3300d1b90d#Appendix_A_65" data-linktype="relative-path">&lt;65&gt;</a></p>
</li><li><p><span><span> 
</span></span>The CA server MUST enforce that FileName is one of the file names
(without the prefix) that could be returned via a call to <span><a href="10ff12aa-8a06-446f-8bc4-94e7f76e3332" data-linktype="relative-path">BackupGetAttachmentInformation</a></span>
or <span><a href="93becc1c-0daf-4891-ab1c-b887c95b0fcd" data-linktype="relative-path">BackupGetBackupLogs</a></span>.</p>
</li><li><p><span><span> 
</span></span>The CA server MUST enforce that the file corresponding to
FileName is accessible to the CA.</p>
</li><li><p><span><span> 
</span></span>Upon successful return, the CA MUST return the size, in bytes, of
the file content in the <i>*pliLength</i> parameter.</p>
</li></ul></div>