IEnroll4::createRequestWStr メソッド (xenroll.h)

  • [アーティクル]

[このメソッドは、Windows Server 2008 および Windows Vista では使用できなくなりました。

createRequestWStr メソッドは、PKCS #10、PKCS #7、または完全な証明書管理 over CMS (CMC) 形式の証明書要求を作成し、BLOB に格納します。 このメソッドは、最初に IEnroll4 インターフェイスで定義されました。

構文

HRESULT createRequestWStr(
  [in]  LONG             Flags,
  [in]  LPCWSTR          pwszDNName,
  [in]  LPCWSTR          pwszUsage,
  [out] PCRYPT_DATA_BLOB pblobRequest
);

パラメーター

[in] Flags

作成する証明書要求の種類を指定する値。 次のいずれかの値を指定します。

値 意味
XECR_CMC
 フル CMC
XECR_PKCS10_V1_5
 PKCS #10
XECR_PKCS10_V2_0
 PKCS #10 バージョン 2
XECR_PKCS7
 PKCS #7

[in] pwszDNName

要求が行われているエンティティの識別名 (DN) を含む null で終わる Unicode 文字列へのポインター。 DN 名は、"CN=User, O=Microsoft" などの X.500 名前付け規則に従う必要があります。 2 文字のプレフィックスが存在しない場合は、代わりにオブジェクト識別子 (OID) を指定できます。 このパラメーターは NULL である可能性があります。

[in] pwszUsage

生成される証明書の目的 (個人または商用の Authenticode 証明書、クライアント認証など) を記述する OID を含む null で終わる Unicode 文字列へのポインター。 複数の OID をコンマで区切って指定することもできます。

[out] pblobRequest

要求を受信 するCRYPT_DATA_BLOB 構造体へのポインター。

このメモリの使用が完了したら、この構造体の pbData メンバーを CoTaskMemFree 関数に渡して解放します。

戻り値

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

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

要件

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

こちらもご覧ください

IEnroll4