Share via

[MS-CSRA] ICertAdminD::BackupPrepare incorrect parameter descriptions

Vadims Podāns 9,266 Reputation points MVP
2025-03-25T10:03:55.26+00:00

In [MS-CSRA] §3.1.4.1.18 ICertAdminD::BackupPrepare method, parameter descriptions for grbitJet and dwBackupFlags are swapped. I.e. grbitJet parameter MUST be 0 and ignored on receipt, while backup type (full/incremental) uses values from the table. That is, description of grbitJet parameter shall be moved to dwBackupFlags and vice versa. In addition, subsequent mentions of grbitJet and dwBackupFlags in this method description shall be swapped as well.

I'm making this assumption since this method is merely a DCOM wrapper around CertSrvBackupPrepareW Win32 function, which has same parameters and parameter descriptions. Based on my tests, the Win32 function description is correct. Backup type is determined by passing an appropriate value in dwBackupFlags and setting grbitJet to 0 in all cases.

Windows development | Windows Open Specifications
Answer accepted by question author
  1. KristianSmith-MSFT 451 Reputation points Microsoft Employee Moderator
    2025-03-26T17:33:27.6066667+00:00

    5/5 EDIT @Vadims Podāns : In working with the engineering team, it turns out that the documentation was actually accurate. While CertSrvBackupPrepareW uses the dwBackupFlags value to compute the appropriate grbitJet flags, the CCertAdminD::BackupPrepare method does not use dwBackupFlags at all. It receives the value as a parameter but ignores it and relies only on the grbitJet value that was passed in. Please let me know if you have any questions.

    Hi Vadims,

    Thank you for pointing out this discrepancy in the documentation. Indeed you are correct in that dwBackupFlags should represent full backup vs. logs only and grbitJet should be 0 and ignored upon receipt. I will work to get this updated in [MS-CSRA] and you can expect to see this reflected in an upcoming version.

    Thanks for your dedication to helping us keep the Open Specifications accurate!

    Regards,
    Kristian S
    Support Escalation Engineer
    Microsoft Open Specifications

    1 person found this answer helpful.

0 additional answers

Sort by: Most helpful
Most helpful Newest Oldest

Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.