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>