3.1.4.1.20 ICertAdminD::BackupGetAttachmentInformation (Opnum 22)

  • Article

The BackupGetAttachmentInformation method is used to query the CA for the names of database files that should become part of the backup file set.

 HRESULT BackupGetAttachmentInformation(
   [out, size_is(, *pcwcDBFiles)] WCHAR** ppwszzDBFiles,
   [out] LONG* pcwcDBFiles
 );

ppwszzDBFiles: A pointer to a WCHAR pointer that will receive the list of null-terminated database file names. Detailed information on database file name structure formatting is specified in section 2.2.4.

pcwcDBFiles: A pointer to an integer value that contains the total length, in characters, of all strings (including a NULL-terminator character) returned in ppwszzDBFiles.

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

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. <51>

  • The CA server MUST return a list of file names associated with the CA database data files required for backup. The files corresponding to the names that are returned MUST be accessible to the CA. Each file name MUST be in UNC format and MUST be prefixed with the "D" character. If there are no database files, the CA MUST set the value of the pcwcDBFiles parameter to 0 and return successfully.