Edit

ICertView2::SetTable method (certview.h)

  • Article

The SetTable method specifies which Certificate Services database table is used for subsequent calls to the methods of the ICertView2 interface.

Syntax

HRESULT SetTable(
  [in] LONG Table
);

Parameters

[in] Table

Specifies the Certificate Services database table to use for subsequent calls. This parameter must be one of the following values.

Value Meaning
CVRC_TABLE_ATTRIBUTES
 The attributes table is used for subsequent calls.
CVRC_TABLE_CRL
 The certificate revocation list (CRL) table is used for subsequent calls.
CVRC_TABLE_EXTENSIONS
 The extensions table is used for subsequent calls.
CVRC_TABLE_REQCERT
 The table of pending requests, denied requests, issued certificates, and revoked certificates is used for subsequent calls.

Return value

VB

If the method succeeds, the method returns S_OK.

If the method fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

Remarks

Before calling the SetTable method, it is necessary to establish a connection with a Certificate Services server by calling the OpenConnection method first. After the OpenConnection and SetTable calls are made, subsequent calls to the ICertView2 interface methods will use the Certificate Services database table specified by the SetTable method.

If the SetTable method is not called, then the default table CVRC_TABLE_REQCERT is used.

Examples

HRESULT hr;

// Specify the certificate revocation list table.
hr = pCertView2->SetTable(CVRC_TABLE_CRL);
if (FAILED(hr))
{
    printf("Failed SetTable\n");
    exit(1);  // Or other error action.
}

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header certview.h (include Certsrv.h)
Library Certidl.lib
DLL Certadm.dll