IAlternativeName::InitializeFromRawData メソッド (certenroll.h)

  • [アーティクル]

InitializeFromRawData メソッドは、デジタル署名アルゴリズム (DSA) GUID、X.500 ディレクトリ名、またはDistinguished Encoding Rules (DER) でエンコードされたバイト配列に含まれるインターネット プロトコル (IP) アドレスからオブジェクトを初期化します。

構文

HRESULT InitializeFromRawData(
  [in] AlternativeNameType Type,
  [in] EncodingType        Encoding,
  [in] BSTR                strRawData
);

パラメーター

[in] Type

入力文字列で表される名前の種類を識別する AlternativeNameType 列挙値。 これは、次のいずれかの値である必要があります。

値 意味
XCN_CERT_ALT_NAME_DIRECTORY_NAME
 名前は X.500 ディレクトリ名です。
XCN_CERT_ALT_NAME_IP_ADDRESS
 名前は IP アドレスです。
XCN_CERT_ALT_NAME_GUID
 名前は GUID です。

[in] Encoding

strRawData パラメーターに適用される Unicode エンコードの種類を識別する EncodingType 列挙値。

[in] strRawData

DER でエンコードされたデータを含む BSTR 変数。

戻り値

関数が成功した場合、関数は S_OKを返します。

関数が失敗した場合は、エラーを示す HRESULT 値を返します。 有効な値を次の表に示しますが、これ以外にもあります。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。

リターン コード 説明
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 オブジェクトは既に初期化されています。

注釈

生データは、Distinguished Encoding Rules (DER) を使用してエンコードされたバイト配列です。 バイト配列は Unicode エンコード文字列として指定する必要があります。

このメソッドを使用して DSA GUID (XCN_CERT_ALT_NAME_GUID) を指定すると、GUID は XCN_OID_NTDS_REPLICATION (1.3.6.1.4.1.311.25.1) オブジェクト識別子 (OID) に関連付けられ、オクテット文字列 (バイト配列) としてエンコードされます。 OID を取得するには、 ObjectId プロパティを呼び出します。 RawData プロパティを呼び出して、エンコードされたバイト配列を取得できます。

このメソッドを使用して次のいずれかの名前の型を指定すると、メソッドは E_INVALIDARGを返します。

値 説明
XCN_CERT_ALT_NAME_UNKNOWN 名前の種類が識別されません。
XCN_CERT_ALT_NAME_RFC822_NAME 名前はメール アドレスです。
XCN_CERT_ALT_NAME_DNS_NAME 名前は DNS 名です。
XCN_CERT_ALT_NAME_URL 名前は URL です。
XCN_CERT_ALT_NAME_REGISTERED_ID 名前は登録済みの OID です。
XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME 名前は ユーザー プリンシパル名 (UPN) です。
XCN_CERT_ALT_NAME_OTHER_NAME 名前は OID とバイト配列で構成されます。
 

InitializeFromOtherName メソッドを使用して OID と対応する名前文字列を指定できます。InitializeFromString メソッドを使用して、電子メール アドレス、DNS 名、URL、登録済み OID、またはユーザー プリンシパル名 (UPN) を指定できます。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー certenroll.h
[DLL] CertEnroll.dll

こちらもご覧ください

IAlternativeName