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 列挙値。 これは、次のいずれかの値である必要があります。

[in] Encoding

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

[in] strRawData

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

戻り値

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

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

注釈

生データは、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を返します。

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

要件

こちらもご覧ください

IAlternativeName