ICertView

適切に権限を付与されたクライアントが、Certificate Services データベースのカスタマイズされたビューまたは完全なビューを作成できるようにします。

Certificate Services サーバーとの接続を確立します。

VB

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

このメソッドが正常に完了すると、 ICertView オブジェクトは strConfig パラメーターで指定された Certificate Services サーバーへの接続を保持します。

接続を閉じるには、Release 関数を呼び出します。

例

ICertView *   pCertView = NULL;
BSTR          strCertServ = NULL;
HRESULT       hr;

// Initialize COM.
hr = CoInitializeEx(NULL, COINIT_APARTMENTTHREADED);

if (FAILED(hr))
{
    printf("Failed CoInitializeEx\n");
    goto error;
}
// Get pointer to the ICertView interface.
hr = CoCreateInstance(CLSID_CCertView,
                      NULL,
                      CLSCTX_INPROC_SERVER,
                      IID_ICertView,
                      (void **)&pCertView);
if (FAILED(hr))
{
    printf("Failed CoCreateInstance\n");
    goto error;
}
// The use of '\\' is necessary to represent a single backslash.
strCertServ = SysAllocString(TEXT("Server01\\ABCCertServ"));
// Open the connection to the Certificate Services server.
hr = pCertView->OpenConnection(strCertServ);
if (FAILED(hr))
{
    printf("Failed OpenConnection!\n");
    goto error;
}
else
    // Established successful connection; use view as appropriate.
    // ...
    // Done using objects; free resources.
error: 
    if (NULL != pCertView)
        pCertView->Release();
    if (NULL != strCertServ)
        SysFreeString(strCertServ);
    // Free COM resources.
    CoUninitialize();

データベーススキーマに対する列の列挙シーケンスのインスタンスを取得します。

C++

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

VB

IEnumCERTVIEWCOLUMN オブジェクトを使用して、ビューの列を列挙し、各列の情報を取得できます。

Certificate Services データベースのビュー内の列数を取得します。

C++

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

VB

このメソッドは、ビュー内の列数を判別するために使用します。返される数値は、fResultColumn が TRUE の場合は結果セットの列数を、fResultColumn が FALSE の場合はデータベーススキーマ全体の列数を表します。

列の 0 から始まるインデックスを取得します。

C++

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

VB

このメソッドは、strColumnName パラメーターで指定された列のインデックスを判別するために使用します。列のインデックスは 0 から始まります(最初の列はインデックス 0 です)。

Certificate Services データベースのカスタマイズされたビューの結果セットに対する最大列数を指定します。

VB

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

SetResultColumnCount メソッドを呼び出す前に、まず OpenConnection メソッドを呼び出して Certificate Services サーバーとの接続を確立する必要があります。接続が確立された後、このメソッドを一度だけ呼び出して、結果セット内の最大列数を指定できます。

cResultColumn パラメーターに(定義済み定数ではなく)正の数値を設定した場合は、 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.
    // ...
}

Certificate Services データベースのカスタマイズされたビューの結果セットに対する列を指定します。

VB

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

SetResultColumn メソッドを呼び出す前に、SetResultColumnCount メソッドを呼び出して、結果セットに含める列数を指定する必要があります。SetResultColumn メソッドの呼び出しは、次の条件下で失敗します。

• 列数が指定されていない。
• SetResultColumn が、SetResultColumnCount の呼び出しで指定された列数を超える回数呼び出された。
• SetResultColumnCount が定義済みの列セットを指定した。cResultColumnCount パラメーターが次のいずれかの値である場合、このメソッドは定義済みの列セットを指定します。
  • CV_COLUMN_LOG_DEFAULT
  • CV_COLUMN_LOG_FAILED_DEFAULT
  • CV_COLUMN_QUEUE_DEFAULT

結果セットに必要な列ごとに SetResultColumn メソッドを呼び出す必要があります。これらの呼び出しが正常に完了すると、各呼び出しで指定された列は、OpenView メソッドが呼び出されたときに結果セットに含まれます。

例

    HRESULT    hr;
    LONG       nCount;
    LONG       i;

    // Determine the number of columns in the entire database.
    // pCertView is a pointer to ICertView.
    hr = pCertView->GetColumnCount(FALSE, &nCount);
    if (FAILED(hr))
    {
        printf("Failed GetColumnCount - %x\n", hr);
        goto error;
    }
    hr = pCertView->SetResultColumnCount( nCount );
    if (FAILED(hr))
    {
        printf("Failed SetResultColumnCount - %x\n", hr);
        goto error;
    }
    // Place each column in the view.
    for (i = 0; i < nCount; i++)
    {
        hr = pCertView->SetResultColumn(i);
        if (FAILED(hr))
        {
            printf("Failed SetResultColumn (%d) - %x\n", i, hr );
            goto error;
        }
    }
    // Call ICertView::OpenView, and so on.
    // ...

error:
    {
         // Clean up resources, and so on.
    }

列に対する並べ替えおよび絞り込みの制限を設定します。

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

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

ICertView オブジェクトは制限の配列を保持しており、各列に任意の数の制限を含めることができます。列の制限が設定された後、ICertView::OpenView メソッドを呼び出すと、各列の制限がデータベースクエリの一部として使用されてデータが取得されます。

SetRestriction メソッドを呼び出す前に、ICertView::OpenConnection メソッドを呼び出して Certificate Service サーバーとの接続を確立する必要があります。

例

    // This example restricts the data
    // to rows that have RequestIDs greater than five.
    // pCertView is a pointer to ICertView.
    HRESULT    hr;
    VARIANT    varRest;
    LONG       nIndex;
    BSTR       bstrCol = NULL;

    // Use one column in the result set.
    hr = pCertView->SetResultColumnCount(1);
    if (FAILED(hr))
    {
        printf("Failed SetResultColumnCount - %x\n", hr);
        goto error;
    }
    // Determine the column index for RequestID column.
    bstrCol = SysAllocString(TEXT("RequestID"));
    hr = pCertView->GetColumnIndex(FALSE, bstrCol, &nIndex);
    if (FAILED(hr))
    {
        printf("Failed GetColumnIndex - %x\n", hr);
        goto error;
    }
    // Place this column into the result set.
    pCertView->SetResultColumn(nIndex);
    // Set a restriction on this column.
    VariantInit(&varRest);
    varRest.vt = VT_I4;
    varRest.lVal = 5;
    // Restrict view to requests with ID greater than 5.
    hr = pCertView->SetRestriction(nIndex,
                                   CVR_SEEK_GT,
                                   CVR_SORT_NONE,
                                   &varRest);
    if (S_OK != hr)
        printf("Failed ICertView::SetRestriction - %x\n", hr);
    else
    {
        // Call OpenView, process rows, release resources, and so on.
        // ...
    }
error:
    // Done processing, clear resources.
    VariantClear(&varRest);
    if (NULL != bstrCol)
        SysFreeString(bstrCol);

Certificate Services データベースへのビューを開き、IEnumCERTVIEWROW オブジェクトのインスタンスを生成します。

C++

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

VB

OpenView メソッドを呼び出す前に、まず OpenConnection メソッドを呼び出して Certificate Services サーバーとの接続を確立する必要があります。

この呼び出しによって返される IEnumCERTVIEWROW オブジェクトは、内部インデックスがシーケンスの先頭を指している行の列挙シーケンスを表します。シーケンス内の最初の行を参照するには、 IEnumCERTVIEWROW::Next メソッドを呼び出します。これにより内部インデックスが最初の行に移動します。

既定以外の列セットや行のサブセットを表示するには、OpenConnection を呼び出した後、OpenView を呼び出す前に、 SetResultColumnCount、 SetResultColumn、 SetRestriction を呼び出します。

例

// pCertView is previously instantiated pointer to ICertView.
IEnumCERTVIEWROW * pEnumRow = NULL;
HRESULT    hr;

hr = pCertView->OpenView(&pEnumRow);
if (S_OK != hr)
    printf("Failed ICertView::OpenView - %x\n", hr);
else
    // use pEnumRow as needed, to enumerate data rows
    // ...
// Done processing, free resources.
if (NULL != pEnumRow)
    pEnumRow->Release();