IEnroll::get_HashAlgorithmWStr メソッド (xenroll.h)

  • [アーティクル]

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

HashAlgorithmWStr プロパティは、PKCS #10 認定要求の署名に使用される署名ハッシュ アルゴリズムのみを設定または取得します。

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

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

構文

HRESULT get_HashAlgorithmWStr(
  LPWSTR *szw
);

パラメーター

szw

戻り値

なし

解説

この署名ハッシュ アルゴリズムは、証明書の署名に使用されるハッシュ アルゴリズムと混同しないようにします。 現在、登録コントロールでは、ハッシュ アルゴリズムの OID に加えて、SHA1 (既定値)、MD2、および MD5 の表示名の値がサポートされています。 このプロパティを取得すると、取得された値は OID 形式になります (つまり、SHA1 は 1.3.14.3.2.29 として表示されます)。 このプロパティを設定する場合は、定義されたフレンドリ値に表示されるテキストの代わりに、対応する OID 形式を使用できます。

証明書登録コントロールは、 HashAlgorithmWStr プロパティの値を、PKCS #10 認定要求の署名に使用するハッシュ アルゴリズムのヒントと見なします。 暗号化サービス プロバイダー (CSP) が HashAlgorithmWStr プロパティで指定されたアルゴリズムをサポートしている場合は、アルゴリズムが使用されます。 それ以外の場合、証明書登録コントロールは SHA1 の使用を試みます。 SHA1 が CSP でサポートされていない場合は、MD5 が試行されます。 SHA1 も MD5 もサポートされていない場合、証明書登録制御は CSP から返された最初のハッシュ アルゴリズムの使用を試みます。

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

HashAlgID プロパティと HashAlgorithmWStr プロパティの両方が設定されている場合、最後に更新された方が、PKCS #10 認定要求の署名に使用するハッシュ アルゴリズムを指定します。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー xenroll.h
Library Uuid.lib
[DLL] Xenroll.dll

関連項目

IEnroll