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 列挙値。 これは、次のいずれかの値である必要があります。
| 値 | 意味 |
|---|---|
|
名前は X.500 ディレクトリ名です。 |
|
名前は IP アドレスです。 |
|
名前は GUID です。 |
[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を返します。
| 値 | 説明 |
|---|---|
| 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 |