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

  • [アーティクル]

InitializeFromString メソッドは、電子メール アドレス、ドメイン ネーム システム (DNS) 名、URL、登録済みオブジェクト識別子 (OID)、またはユーザー プリンシパル名 (UPN) を含む文字列からオブジェクトを初期化します。

構文

HRESULT InitializeFromString(
  [in] AlternativeNameType Type,
  [in] BSTR                strValue
);

パラメーター

[in] Type

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

値 意味
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 です。

[in] strValue

名前を含む BSTR 変数。

戻り値

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

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

解説

このメソッドを使用して UPN を指定すると、UPN は XCN_OID_NT_PRINCIPAL_NAME (1.3.6.1.4.1.311.20.2.3) OID に関連付けられて、Distinguished Encoding Rules (DER) エンコードされます。 RawData プロパティを呼び出して、エンコードされたバイト配列を取得できます。 OID を取得するには、 ObjectId プロパティを呼び出します。

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

値 説明
XCN_CERT_ALT_NAME_UNKNOWN 名前の種類が識別されません。
XCN_CERT_ALT_NAME_OTHER_NAME 名前は OID とバイト配列で構成されます。
XCN_CERT_ALT_NAME_DIRECTORY_NAME 名前は X.500 ディレクトリ名です。
XCN_CERT_ALT_NAME_IP_ADDRESS 名前は IP アドレスです。
XCN_CERT_ALT_NAME_GUID 名前は GUID です。
 

InitializeFromOtherName メソッドを使用して OID と対応する名前文字列を指定し、InitializeFromRawData メソッドを使用して GUID、IP アドレス、または X.500 ディレクトリ名を指定できます。

要件

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

関連項目

IAlternativeName

IAlternativeNames

IX509ExtensionAlternativeNames