ICEnroll2

ICEnroll2 インターフェイスは、Certificate Enrollment Control を表す複数のインターフェイスの 1 つです。

証明書テンプレートを要求に追加します(エンタープライズ証明機関(CA)をサポートするために使用します)。このメソッドは ICEnroll2 インターフェイスで最初に定義されました。

VB

要求に対して複数の証明書テンプレートが必要な場合は、このメソッドを複数回呼び出すことができます。

属性の認証された名前と値のペアを要求に追加します。名前と値のペアの意味をどう解釈するかは証明機関(CA)に委ねられます。

VB

addNameValuePairToSignature メソッドは、要求に属性を追加するために使用します。

例

BSTR bstrName = NULL;
BSTR bstrValue = NULL;
HRESULT hr;

// Allocate the name. Alternatively, (L"2.5.4.6").
bstrName = SysAllocString(TEXT(szOID_COUNTRY_NAME));
// Allocate the value.
bstrValue = SysAllocString(L"US");

if (NULL == bstrName || NULL == bstrValue)
{
    // handle error
}

// add the name-value pair to the signature
// pEnroll is previously instantiated ICEnroll4 interface pointer
hr = pEnroll->addNameValuePairToSignature( bstrName, bstrValue );
if ( FAILED( hr ) )
    printf("Failed addNameValuePairToSignature - %x\n", hr );
else
    printf("addNameValuePairToSignature(%ws, %ws) succeeded\n",
            bstrName, 
            bstrValue );

// free BSTRs
if (bstrName )
    SysFreeString( bstrName );
if (bstrValue )
    SysFreeString( bstrValue );

証明書をユーザーの Active Directory ストアに書き込むかどうかを決定するブール値を設定または取得します。(Get)

WriteCertToUserDS は、次のメソッドの動作に影響します。

• acceptPKCS7
• acceptFilePKCS7

Certificate Enrollment Control がスクリプト化されたコントロールとして実行される場合、このプロパティを設定する機能は無効になります。

例

BOOL     bWriteUserDS;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll2 interface pointer

// get the WriteCertToUserDS value
hr = pEnroll->get_WriteCertToUserDS( &bWriteUserDS );
if (FAILED( hr ))
    printf("Failed get_WriteCertToUserDS - %x\n", hr );
else
    printf( "WriteCertToUserDS: %d\n", bWriteUserDS );

// set the WriteCertToUserDS value
hr = pEnroll->put_WriteCertToUserDS( TRUE );
if (FAILED( hr ))
    printf("Failed put_WriteCertToUserDS - %x\n", hr );
else
    printf( "WriteCertToUserDS set to TRUE\n" );

証明書をユーザーの Active Directory ストアに書き込むかどうかを決定するブール値を設定または取得します。(Put)

WriteCertToUserDS は、次のメソッドの動作に影響します。

• acceptPKCS7
• acceptFilePKCS7

Certificate Enrollment Control がスクリプト化されたコントロールとして実行される場合、このプロパティを設定する機能は無効になります。

例

BOOL     bWriteUserDS;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll2 interface pointer

// get the WriteCertToUserDS value
hr = pEnroll->get_WriteCertToUserDS( &bWriteUserDS );
if (FAILED( hr ))
    printf("Failed get_WriteCertToUserDS - %x\n", hr );
else
    printf( "WriteCertToUserDS: %d\n", bWriteUserDS );

// set the WriteCertToUserDS value
hr = pEnroll->put_WriteCertToUserDS( TRUE );
if (FAILED( hr ))
    printf("Failed put_WriteCertToUserDS - %x\n", hr );
else
    printf( "WriteCertToUserDS set to TRUE\n" );

ICEnroll4 の EnableT61DNEncoding プロパティは、要求内の識別名を Unicode 文字列ではなく T61 文字列としてエンコードするかどうかを決定するブール値を設定または取得します。(Get)

EnableT61DNEncoding プロパティは、次のメソッドの動作に影響します。

• createPKCS10
• createFilePKCS10

例

BOOL     bT61DN;
HRESULT  hr;


// pEnroll is a previously instantiated ICEnroll2 interface pointer.
// Get the EnableT61DNEncoding Boolean value.

hr = pEnroll->get_EnableT61DNEncoding( &bT61DN );
if ( FAILED ( hr ) )
    printf("Failed get_EnableT61DNEncoding - %x\n", hr );
else
    printf( "T61DNEncoding: %s\n", 
             ( bT61DN ? "Enabled" : "Disabled" ) );


// Set the EnableT61DNEncoding value.

hr = pEnroll->put_EnableT61DNEncoding( TRUE );
if ( FAILED ( hr ) )
    printf("Failed Setting EnableT61DNEncoding - %x\n", hr );
else
    printf( "EnableT61DNEncoding was set to TRUE\n" );

ICEnroll4 の EnableT61DNEncoding プロパティは、要求内の識別名を Unicode 文字列ではなく T61 文字列としてエンコードするかどうかを決定するブール値を設定または取得します。(Put)

EnableT61DNEncoding プロパティは、次のメソッドの動作に影響します。

• createPKCS10
• createFilePKCS10

例

BOOL     bT61DN;
HRESULT  hr;


// pEnroll is a previously instantiated ICEnroll2 interface pointer.
// Get the EnableT61DNEncoding Boolean value.

hr = pEnroll->get_EnableT61DNEncoding( &bT61DN );
if ( FAILED ( hr ) )
    printf("Failed get_EnableT61DNEncoding - %x\n", hr );
else
    printf( "T61DNEncoding: %s\n", 
             ( bT61DN ? "Enabled" : "Disabled" ) );


// Set the EnableT61DNEncoding value.

hr = pEnroll->put_EnableT61DNEncoding( TRUE );
if ( FAILED ( hr ) )
    printf("Failed Setting EnableT61DNEncoding - %x\n", hr );
else
    printf( "EnableT61DNEncoding was set to TRUE\n" );