ICertView::SetResultColumnCount メソッド (certview.h)

[アーティクル]
02/26/2024

SetResultColumnCount メソッドは、Certificate Services データベースのカスタマイズされたビューの結果セットの列の最大数を指定します。

構文

HRESULT SetResultColumnCount(
  [in] LONG cResultColumn
);

パラメーター

[in] cResultColumn

結果セット内の列の最大数を指定します。このパラメーターは正の数に設定することも、Certificate Services データベースの行を数えるだけの場合は 0 に設定することも、次のいずれかの定数に設定することもできます。

値	意味
CV_COLUMN_LOG_DEFAULT	結果セット内の列数は、解決された要求に対する証明書サービスの既定の結果セット内の列数になります。発行された証明書または失敗した要求が発生した場合、要求は解決されます。失効した証明書は解決済みと見なされます。
CV_COLUMN_LOG_FAILED_DEFAULT	結果セット内の列数は、失敗した要求に対する証明書サービスの既定の結果セット内の列数になります。
CV_COLUMN_QUEUE_DEFAULT	結果セット内の列数は、解決されていない要求に対する証明書サービスの既定の結果セット内の列の数になります。

戻り値

VB

メソッドが成功した場合、メソッドは S_OKを返します。

メソッドが失敗した場合は、エラーを示す HRESULT 値を返します。一般的なエラーコードの一覧については、「共通の HRESULT 値」を参照してください。

注釈

SetResultColumnCount メソッドを呼び出す前に、最初に OpenConnection メソッドを呼び出して証明書サービスサーバーとの接続を確立する必要があります。接続が確立されると、このメソッドを 1 回だけ呼び出して、結果セット内の列の最大数を指定できます。

cResultColumn パラメーターが正の数 (定義済みの定数の 1 つではない) に設定されている場合は、SetResultColumn メソッドを呼び出して、結果セットに含める列を指定する必要があります。 SetResultColumn は、SetResultColumnCount で指定された列数を超えて呼び出されると失敗します。

例

HRESULT    hr;
// Specify the result set for logged requests.
// pCertView is pointer to ICertView (which has an Open Connection)
hr = pCertView->SetResultColumnCount(CV_COLUMN_LOG_DEFAULT);
if (S_OK != hr)
    printf("Failed ICertView::SetResultColumnCount - %x\n", hr);
else
{
    // Retrieve data rows by means of ICertView::OpenView.
    // ...
}

要件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	certview.h (Certsrv.h を含む)
Library	Certidl.lib
[DLL]	Certadm.dll