ICEnroll::get_WriteCertToCSP メソッド (xenroll.h)

[このプロパティは、Windows Server 2008 および Windows Vista では使用できなくなりました。

WriteCertToCSP プロパティは、証明書を暗号化サービス プロバイダー (CSP) に書き込む必要があるかどうかを決定するブール値を設定または取得します。

このプロパティは、 ICEnroll インターフェイスによって最初に定義されました。

このプロパティは読み取り/書き込み可能です。

構文

HRESULT get_WriteCertToCSP(
  BOOL *fBool
);

パラメーター

fBool

戻り値

なし

解説

このプロパティは通常、スマート カードと共に使用されます。この場合、証明書は "MY" ストアに書き込まれるだけでなく、スマート カードに書き込まれます。

既定値は true です。つまり、証明書登録コントロールは証明書を CSP に書き込もうとしますが、ハードウェア トークン エラーが発生しない限り失敗しません。 この値が true の場合、スマート カードまたはその他のハードウェアに依存する CSP がインストールされていない場合、ハードウェア トークン エラーは無視されます。

証明書登録制御が CSP への書き込みを試みないことを明示的に強制するには、この値を false に設定します。

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

• acceptPKCS7
• acceptFilePKCS7

例

BOOL     bWriteCSP;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

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

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

要件