ISCrdEnr::setSigningCertificate メソッド

setSigningCertificate メソッドは、署名証明書 (登録エージェント証明書とも呼ばれます) を指定します。

ユーザーの代わりに登録する前に、署名証明書を選択または設定する必要があります。 この署名証明書に関連付けられている 秘密キー は、PKCS #7 要求に署名するために使用されます。 PKCS #7 には、ユーザーの PKCS #10 要求 (ユーザーの秘密キーで署名されています) が含まれています。

構文

HRESULT setSigningCertificate(
  [in] DWORD dwFlags,
  [in] BSTR bstrCertTemplateName
);

SCrdEnr.setSigningCertificate( _
  ByVal dwFlags, _
  ByVal bstrCertTemplateName _
)

パラメーター

dwFlags [in]

将来利用するために予約されています。 この値を 0 に設定します。

bstrCertTemplateName [in]

署名証明書の証明書テンプレートの名前。 EnrollmentAgent 証明書を取得している場合は、値 "EnrollmentAgent" を使用できます。

戻り値

VB

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

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

解説

ユーザーの代わりに登録する前に、まず署名証明書を取得する必要があります。 署名証明書は、証明書マネージャー MMC スナップインを使用して取得できます。 setSigningCertificate メソッドは署名証明書を取得しませんが、使用する署名証明書を以前に取得したスマート カード登録コントロールに通知します。 setSigningCertificate メソッドは、呼び出し元の "My" ストアで、bstrCertTemplateName で指定された証明書テンプレートに対応する最新の署名証明書を検索します。

setSigningCertificate の代わりに ISCrdEnr::setSigningCertificate があります。

署名証明書が設定されたら、 ISCrdEnr::getSigningCertificateName を呼び出すことによって、その名前を取得できます。

必要条件

関連項目

ISCrdEnr

ISCrdEnr::getSigningCertificateName