ICertAdmin2

適切に承認されたクライアントに管理機能を提供します。

証明機関 (CA) の証明書失効リスト (CRL) を発行します。

CA がベースおよび差分 CRL を正常に発行したかどうかを確認するには、それぞれ CR_PROP_BASECRLPUBLISHSTATUS および CR_PROP_DELTACRLPUBLISHSTATUS プロパティ識別子を指定して ICertAdmin2::GetCAProperty を呼び出します。

例

次の例は CRL の発行を示しています。

    DATE ExpDate;  // CRL expiration date.
    SYSTEMTIME st;
    BSTR bstrCA = NULL;

    //  Set the CRL expiration date to noon, July 1, 2001.
    //  Zero out values first (avoids setting minutes,
    //  seconds, and so on).
    memset(&st, 0, sizeof(SYSTEMTIME));
    st.wYear = 2001;
    st.wMonth = 7;     // July
    st.wDay = 1;       // first day of month
    st.wHour = 12;     // noon

    //  Place the date in required format.
    if (!SystemTimeToVariantTime(&st, &ExpDate))
    {
        printf("Unable to convert time\n");
        goto error;
    }

    bstrCA = SysAllocString(L"<COMPUTERNAMEHERE>\\<CANAMEHERE>");
    if (NULL == bstrCA)
    {
        printf("Memory allocation failed\n");
        goto error;
    }

    //  Publish the CRL.
    //  pCertAdmin is a previously instantiated ICertAdmin object.
    hr = pCertAdmin2->PublishCRLs(bstrCA,
                              ExpDate,
                              CA_CRL_BASE);
    if (FAILED(hr))
    {
        printf("Failed PublishCRLs [%x]\n", hr);
        goto error;
    }
    else
        printf("PublishCRLs succeeded\n");
    //  Done.

error:

    //  Free resources.
    if (bstrCA)
        SysFreeString(bstrCA);

証明機関 (CA) のプロパティ値を取得します。(ICertAdmin2.GetCAProperty)

C++

VB

プロパティ識別子が CR_PROP_BASECRLPUBLISHSTATUS または CR_PROP_DELTACRLPUBLISHSTATUS の場合、次の値が返されます。これらの値は組み合わせることができます。

CRL を取得する例については、証明書失効リストの取得を参照してください。

例

次の例は、CA の署名証明書の取得を示しています。この例では、ICertAdmin2 インターフェイス ポインターが有効であることを前提としています。

BSTR bstrCA = NULL;
VARIANT var1;
HRESULT hr;

bstrCA = SysAllocString(L"<COMPUTERNAMEHERE>\\<CANAMEHERE>");
if (NULL == bstrCA)
{
    printf("Failed to allocate memory for bstrCA\n");
    exit(1);
}

VariantInit(&var1);
// Retrieve the CA signature certificate at index 0.
hr = pAdmin2->GetCAProperty(bstrCA,
                                CR_PROP_CASIGCERT,
                                0,
                                PROPTYPE_BINARY,
                                CV_OUT_BASE64HEADER,
                                &var1);
if (FAILED(hr))
{
    printf("Failed GetCAProperty\n");
    SysFreeString(bstrCA);
    exit(1);  // Or other error action.
}

// Use the property as needed.
// ...

// Clear the variant when finished.
VariantClear(&var1);
SysFreeString(bstrCA);

証明機関 (CA) のプロパティ値を設定します。

VB

関数が失敗した場合、戻り値はエラーを示す HRESULT です。一般的なエラー コードの一覧については、一般的な HRESULT 値を参照してください。

ICertAdmin2::GetCAPropertyFlags メソッドは、証明機関 (CA) プロパティのプロパティ フラグを取得します。

C++

VB

このメソッドを呼び出して取得した LONG 値を調べることで、データ型とインデックス付き状態を判別できます。データ型とインデックス付き状態を判別するには、それぞれ PROPTYPE_MASK 値と PROPFLAGS_INDEXED 値を使用します。

例

次の例では、ICertAdmin2 インターフェイス ポインターが有効であることを前提としています。

BSTR bstrCA = NULL;
LONG nFlags;  // Variable to contain the property flags.

bstrCA = SysAllocString(L"<COMPUTERNAMEHERE>\\<CANAMEHERE>");
if (NULL == bstrCA)
{
    printf("Failed to allocate memory for bstrCA\n");
    exit(1);
}

// Retrieve a property's flags.
hr = pCertAdmin2->GetCAPropertyFlags(bstrCA,
                                     CR_PROP_EXITCOUNT,
                                     &nFlags);
if (FAILED(hr))
{
    printf("Failed GetCAPropertyFlags\n");
    SysFreeString(bstrCA);
    exit(1);  // Or other error action.
}
// Display the property data type.
switch (nFlags & PROPTYPE_MASK)
{
    case PROPTYPE_BINARY:
        printf("Type is BINARY\n");
        break;
    case PROPTYPE_DATE:
        printf("Type is DATE\n");
        break;
    case PROPTYPE_LONG:
        printf("Type is LONG\n");
        break;
    case PROPTYPE_STRING:
        printf("Type is STRING\n");
        break;
    default:
        printf("Unexpected data type.\n");
        break;
}
// Display the property's indexed status.
printf("Property %s indexed\n", 
       nFlags & PROPFLAGS_INDEXED ? "is" : "is not");

SysFreeString(bstrCA);

ICertAdmin2::GetCAPropertyDisplayName メソッドは、証明機関 (CA) プロパティのプロパティ表示名を取得します。

C++

VB

アーカイブされたキー回復 BLOB を取得します。

C++

VB

アーカイブされたキーは、1 つまたは複数のキー回復エージェント証明書に対して PKCS #7 で暗号化され、その形式で Certificate Services データベースに格納されます。このメソッドは、暗号化された PKCS #7 を Certificate Services データベースから取得し、ユーザー証明書とそのチェーン、1 つまたは複数のキー回復エージェント証明書、および証明機関の署名証明書とそのチェーンを含む署名済み PKCS #7 でラップします。認証属性には、ユーザー証明書を一意に識別するために使用される証明書が含まれます。

証明機関 (CA) の構成情報を取得します。

C++

関数が失敗した場合、戻り値はエラーを示す HRESULT です。一般的なエラー コードの一覧については、一般的な HRESULT 値を参照してください。

VB

構成情報は、レジストリの次のパスの下に格納されます。

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\CertSvc\Configuration\[CASANITIZEDNAME]\[strNodePath]\[strEntryName]

証明機関 (CA) の構成情報を設定します。

VB

関数が失敗した場合、戻り値はエラーを示す HRESULT です。一般的なエラー コードの一覧については、一般的な HRESULT 値を参照してください。

構成情報は、レジストリの次のパスの下に格納されます。

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\CertSvc\Configuration\[CASANITIZEDNAME]\[strNodePath]\[strEntryName]

暗号化されたキー セットを Certificate Services データベース内の項目に追加します。キー セットは、1 つまたは複数のキー回復エージェント (KRA) 証明書に対して暗号化されます。

呼び出し元の証明機関 (CA) 役割を取得します。

C++

関数が失敗した場合、戻り値はエラーを示す HRESULT です。一般的なエラー コードの一覧については、一般的な HRESULT 値を参照してください。

VB

DeleteRow メソッドは、データベース テーブルから 1 行または複数の行を削除します。呼び出し元は、データベース テーブルと、行 ID または終了日のいずれかを指定します。

C++

VB

RowID と Date は相互排他的です。どちらか一方のみが 0 以外の値を取ることができます。