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 |