<div class="content"><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 <a href="c6451297-197d-4b4b-b786-3f3187b67b8f#gt_c9507dca-291d-4fd6-9cba-a9ee7da8c908" data-linktype="relative-path">UNC</a> 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 <a href="c6451297-197d-4b4b-b786-3f3187b67b8f#gt_c925d5d7-a442-4ba4-9586-5f94ccec847a" data-linktype="relative-path">CA</a>
server MUST enforce the sequencing rules for BackupOpenFile as specified in
section <a href="e37640b4-b2e1-4bac-89d2-61fc5a5e6c1d" data-linktype="relative-path">3.1.4.1.18</a>.<a id="Appendix_A_Target_54"></a><a aria-label="Product behavior note 54" href="5f06c74c-1a29-4fdf-b8dd-ae3300d1b90d#Appendix_A_54" data-linktype="relative-path">&lt;54&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_55"></a><a aria-label="Product behavior note 55" href="5f06c74c-1a29-4fdf-b8dd-ae3300d1b90d#Appendix_A_55" data-linktype="relative-path">&lt;55&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 <a href="10ff12aa-8a06-446f-8bc4-94e7f76e3332" data-linktype="relative-path">BackupGetAttachmentInformation</a>
or <a href="93becc1c-0daf-4891-ab1c-b887c95b0fcd" data-linktype="relative-path">BackupGetBackupLogs</a>.</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>