3.2.4.1.12 ICertAdminD::OpenView (Opnum 14)

The OpenView method obtains the column values for rows associated with a particular resultant set of rows from a table:

  • pwszAuthority: See the pwszAuthority definition in section 3.1.4.1.1.

  • acvr: Each structure in the array MUST contain the information for individual restrictions on a specific column to be applied to the associated table data before the resultant data is returned by the CA. The array of restrictions MUST be encoded as specified in CERTVIEWRESTRICTION.

  • acolOut: Each DWORD value specifies the column identifier for the output. Column identifiers MUST be obtained by using one of the following methods: EnumViewColumn, EnumViewColumnTable, or GetViewDefaultColumnSet.

If the marshaled data buffer returned in pctbResultRows includes space for an extra CERTTRANSDBRESULTROW structure in addition to the row count returned in *pcelt, and if the extra CERTTRANSDBRESULTROW structure's rowid and ccol fields are bitwise inverses of each other, then the field can be relied upon by the client as the total number of rows in the currently active view.

The client SHOULD invoke calls to OpenView, EnumView, and CloseView in the proper sequence, defined as the sequence enforced by the server and documented in sequencing rules in sections 3.1.4.1.12, 3.1.4.1.13, and 3.1.4.1.14.

If the sequence is not followed, the server responds as documented in the server processing rules in section 3.1.4.1.12, 3.1.4.1.13, and 3.1.4.1.14.