3.1.4.1.22 ICertAdminD::BackupOpenFile (Opnum 24)

  • Article

The BackupOpenFile method opens a file for backup.

 HRESULT BackupOpenFile(
   [in, string, unique] wchar_t const* pwszPath,
   [out] unsigned hyper* pliLength
 );

pwszPath: A null-terminated UNICODE string that specifies the path to the targeted file. The file name MUST be UNC form, for example: "\\server\sharepoint\...path...\filename.ext".

pliLength: A pointer to a signed 64-bit integer that receives the size, in bytes, of the targeted file.

The CA server MUST enforce the sequencing rules for BackupOpenFile as specified in section 3.1.4.1.18.<54>

The CA server MUST apply the following processing rules:

  • If Config_CA_Interface_Flags contains the value IF_NOREMOTEICERTADMINBACKUP, the server SHOULD return an error.<55>

  • The CA server MUST enforce that FileName is one of the file names (without the prefix) that could be returned via a call to BackupGetAttachmentInformation or BackupGetBackupLogs.

  • The CA server MUST enforce that the file corresponding to FileName is accessible to the CA.

  • Upon successful return, the CA MUST return the size, in bytes, of the file content in the *pliLength parameter.