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

InitializeFromOtherName メソッドは、オブジェクト識別子 (OID) と関連する生データ (バイト配列) からオブジェクトを初期化します。 このメソッドは、抽象構文表記 1 (ASN.1) AlternativeNames 拡張宣言の otherName フィールドをサポートするために提供されます。

----------------------------------------------------------------------
-- AlternativeNames 
-- XCN_OID_SUBJECT_ALT_NAME2 (2.5.29.17)
----------------------------------------------------------------------

AltNames ::= SEQUENCE --#public-- OF GeneralName
GeneralNames ::= AltNames

GeneralName ::= CHOICE 
{
   otherName               [0] IMPLICIT OtherName,
   rfc822Name              [1] IMPLICIT IA5STRING,
   dNSName                 [2] IMPLICIT IA5STRING,
   x400Address             [3] IMPLICIT SeqOfAny,       -- Not supported
   directoryName           [4] EXPLICIT ANY,    
   ediPartyName            [5] IMPLICIT SeqOfAny,
   uniformResourceLocator  [6] IMPLICIT IA5STRING,
   iPAddress               [7] IMPLICIT OCTETSTRING,
   registeredID            [8] IMPLICIT EncodedObjectID -- Not supported
}

OtherName ::= SEQUENCE 
{
   type                    EncodedObjectID,
   value                   [0] EXPLICIT NOCOPYANY 
}

構文

HRESULT InitializeFromOtherName(
  [in] IObjectId    *pObjectId,
  [in] EncodingType Encoding,
  [in] BSTR         strRawData,
  [in] VARIANT_BOOL ToBeWrapped
);

パラメーター

[in] pObjectId

OID を表す IObjectId インターフェイスへのポインター。

[in] Encoding

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

[in] strRawData

OID に関連付けられている名前を含む BSTR 変数。

[in] ToBeWrapped

strRawData パラメーターに含まれる入力文字列がエンコードされ、オクテット文字列 (バイト配列) として保存されるかどうかを識別するVARIANT_BOOL変数。

戻り値

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

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

注釈

この関数を使用すると、OID と関連付けられた文字列値から IAlternativeName オブジェクトを初期化できます。 文字列は Unicode エンコード済みです。 ToBeWrapped パラメーターに true を指定した場合、文字列は Distinguished Encoding Rules (DER) を使用してエンコードされます。 OID を取得するには、 ObjectId プロパティを呼び出します。 エンコードされた文字列を取得するか、 ToBeWrapped が true の場合は、 RAWData プロパティを呼び出してエンコードされたバイト配列を取得することで、DER でエンコードされたバイト配列を取得できます。

要件

こちらもご覧ください

IAlternativeName