ICEnroll::p ut_DeleteRequestCert メソッド (xenroll.h)

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

DeleteRequestCert プロパティは、要求ストア内のダミー証明書を削除するかどうかを決定するブール値を設定または取得します。

ダミー証明書は、登録プロセス中に PKCS #10 要求用に生成されたキーを保持するために作成されます。 RequestStoreName プロパティで指定されたストアは、ダミー証明書が作成される場所です。 新しく生成されたキーは、 証明機関 が要求を処理し、PKCS #7 で応答するまで保持するために、ダミー証明書にプロパティとして追加されます。 PKCS #7 に同意すると、ダミー証明書が削除され、証明機関から返された発行された証明書のプロパティとしてキーが追加されます。 デバッグとテストでは、ダミー証明書を削除しないことをお勧めします。 DeleteRequestCert プロパティを FALSE に設定すると、削除できなくなります。

このプロパティの既定値は TRUE です。 このプロパティは、 ICEnroll インターフェイスで最初に定義されました。

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

構文

HRESULT put_DeleteRequestCert(
  BOOL fDelete
);

パラメーター

fDelete

戻り値

なし

解説

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

• acceptPKCS7
• acceptFilePKCS7

例

BOOL     bDRC;
HRESULT  hr;


// pEnroll is a previously instantiated ICEnroll interface pointer.
// Get the DeleteRequestCert Boolean value.

hr = pEnroll->get_DeleteRequestCert( &bDRC );
if ( FAILED ( hr ) )
    printf("Failed getting DeleteRequestCert - %x\n", hr );
else
    printf( "DeleteRequestCert: %s\n", ( bDRC ? "TRUE" : "FALSE" ) );


// Set the DeleteRequestCert value.

hr = pEnroll->put_DeleteRequestCert( FALSE );
if ( FAILED ( hr ) )
    printf("Failed Setting DeleteRequestCert - %x\n", hr );
else
    printf( "DeleteRequestCert was set to FALSE\n" );

要件