3.1.4.1.10 ICertAdminD::GetViewDefaultColumnSet (Opnum 12)

The GetViewDefaultColumnSet method returns an array of column identifiers that are associated with a specific view.

 HRESULT GetViewDefaultColumnSet(
   [in, string, unique] wchar_t const* pwszAuthority,
   [in] DWORD iColumnSetDefault,
   [out] DWORD* pcColumn,
   [out, ref] CERTTRANSBLOB* pctbColumnInfo
 );

pwszAuthority: See the definition of the pwszAuthority parameter in ICertAdminD::SetExtension (section 3.1.4.1.1).

iColumnSetDefault: An unsigned integer value that specifies the requested default column set to get. The value MUST be one of the values in the following table. If a value other than one of the listed values is used, the error E_INVALIDARG is returned.

Value

Meaning

0xFFFFFFFF

The caller attempts to retrieve the list of column identifiers that are useful for viewing pending requests.

0xFFFFFFFE

The caller attempts to retrieve the list of column identifiers that are useful for viewing issued certificates.

0xFFFFFFFD

The caller attempts to retrieve the list of column identifiers that are useful for viewing failed requests.

0xFFFFFFFC

The caller attempts to retrieve the list of column identifiers that are useful for viewing extensions.

0xFFFFFFFB

The caller attempts to retrieve the list of column identifiers that are useful for viewing attributes.

0xFFFFFFFA

The caller attempts to retrieve the list of column identifiers that are useful for viewing CRLs.

0xFFFFFFF9

The caller attempts to retrieve the list of column identifiers that are useful for viewing revoked certificates.

pcColumn: A pointer to the unsigned integer that receives the count of Column identifiers that are returned by the server in the pctbColumnInfo parameter.

pctbColumnInfo: A pointer to a CERTTRANSBLOB structure. Its cb member MUST contain the length, in bytes, of the array that is referenced by the pb member. The pb member MUST point to an array of DWORDs, where each DWORD value represents the identifier for a column. Each DWORD in the array is marshaled by using little-endian format.

The CA server MUST return the array of associated column identifiers in the following manner.

Value of the iColumnSetDefault parameter

Processing rule

0xFFFFFFFF

The CA MUST return a subset of column identifiers for a pending request view from the Request table.<39>

0xFFFFFFFE

The CA MUST return a subset of column identifiers for issued and revoked certificate views and failed request view from the Request table.<40>

0xFFFFFFFD

The CA MUST return a subset of column identifiers for a failed request view from the Request table.<41>

0xFFFFFFFC

The CA MUST return a subset of column identifiers for an extension view from the Extension table.<42>

0xFFFFFFFB

The CA MUST return a subset of column identifiers for an attribute view from the Attribute table.<43>

0xFFFFFFFA

The CA MUST return a subset of column identifiers for a CRL view from the CRL table.<44>

0xFFFFFFF9

The CA MUST return a subset of column identifiers for a revoked certificate view from the Request table.<45>