IAlternativeName インターフェイス (certenroll.h)
IAlternativeName インターフェイスのコレクションは、AlternativeNames 拡張機能のインスタンスを表すために IX509ExtensionAlternativeNames オブジェクトによって使用されます。 コレクションは、 IAlternativeNames インターフェイスによって表されます。 次の構文は、拡張機能の 抽象構文表記 1 (ASN.1) 構造を示しています。
----------------------------------------------------------------------
-- 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
}
AlternativeNameType 列挙体から IAlternativeName オブジェクトを初期化できます。 次の型を使用できますが、示されているさまざまな初期化方法でサポートされています。
| 値 | 説明 | 初期化メソッド |
|---|---|---|
| XCN_CERT_ALT_NAME_OTHER_NAME | 名前は 、オブジェクト識別子 (OID) とバイト配列で構成されます。 | InitializeFromOtherName |
| XCN_CERT_ALT_NAME_RFC822_NAME | 名前はメール アドレスです。 | InitializeFromString |
| XCN_CERT_ALT_NAME_DNS_NAME | 名前はドメイン ネーム システム (DNS) 名です。 | InitializeFromString |
| XCN_CERT_ALT_NAME_DIRECTORY_NAME | 名前は X.500 ディレクトリ名です。 | InitializeFromRawData |
| XCN_CERT_ALT_NAME_URL | 名前は URL です。 | InitializeFromString |
| XCN_CERT_ALT_NAME_IP_ADDRESS | 名前はインターネット プロトコル (IP) アドレスです。 | InitializeFromRawData |
| XCN_CERT_ALT_NAME_REGISTERED_ID | 名前は登録済みの OID です。 | InitializeFromString |
| XCN_CERT_ALT_NAME_GUID | 名前は GUID です。 | InitializeFromRawData |
| XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME | 名前は ユーザー プリンシパル名 (UPN) です。 | InitializeFromString |
継承
IAlternativeName インターフェイスは、IDispatch インターフェイスから継承されます。 IAlternativeName には、次の種類のメンバーもあります。
メソッド
IAlternativeName インターフェイスには、これらのメソッドがあります。
| IAlternativeName::get_ObjectId 名前に関連付けられているオブジェクト識別子 (OID) (存在する場合) を取得します。 |
| IAlternativeName::get_RawData 名前を含むDistinguished Encoding Rules (DER) でエンコードされたバイト配列を取得します。 |
| IAlternativeName::get_StrValue 電子メール アドレス、ドメイン ネーム システム (DNS) 名、URL、登録済みオブジェクト識別子 (OID)、またはユーザー プリンシパル名 (UPN) を含む文字列を取得します。 |
| IAlternativeName::get_Type 代替名の種類を取得します。 |
| IAlternativeName::InitializeFromOtherName オブジェクト識別子 (OID) と関連付けられている生データ (バイト配列) からオブジェクトを初期化します。 |
| IAlternativeName::InitializeFromRawData デジタル署名アルゴリズム (DSA) GUID、X.500 ディレクトリ名、またはDistinguished Encoding Rules (DER) でエンコードされたバイト配列に含まれるインターネット プロトコル (IP) アドレスからオブジェクトを初期化します。 |
| IAlternativeName::InitializeFromString 電子メール アドレス、ドメイン ネーム システム (DNS) 名、URL、登録済みオブジェクト識別子 (OID)、またはユーザー プリンシパル名 (UPN) を含む文字列からオブジェクトを初期化します。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | certenroll.h |