ICertEncodeAltName::SetNameEntry メソッド (certenc.h)

SetNameEntry メソッドは、代替名配列の指定したインデックス位置に名前を設定します。

このメソッドを使用する前に、 ICertEncodeAltName::Reset を呼び出して、オブジェクトが配列内の要素の数を認識できるようにする必要があります。

構文

HRESULT SetNameEntry(
  [in] LONG       NameIndex,
  [in] LONG       NameChoice,
  [in] const BSTR strName
);

[in] NameIndex

設定する代替名エントリのインデックスを指定する 0 から始まるインデックス。

NameChoice パラメーターがCERT_ALT_NAME_OTHER_NAMEの場合、OR (|) は、OID を設定するEAN_NAMEOBJECTID (0x80000000として定義) を持つインデックス値です。それ以外の場合は、バイナリ値が設定されます。

[in] NameChoice

名前の選択を指定します。名前の選択は、代替名を正しく使用できるように、代替名の種類を示します。次のいずれかの値を指定する必要があります。

値	意味
CERT_ALT_NAME_DIRECTORY_NAME	名前はディレクトリ名です。
CERT_ALT_NAME_DNS_NAME	名前は、host.entity.domain 形式の DNS (ドメインネームシステム) 名を指定する IA5 文字列です。
CERT_ALT_NAME_IP_ADDRESS	名前は、インターネットプロトコルアドレスを表すオクテット文字列です。
CERT_ALT_NAME_REGISTERED_ID	名前は登録済みオブジェクト識別子 (OID) です。
CERT_ALT_NAME_RFC822_NAME	名前はメールアドレスです。
CERT_ALT_NAME_URL	名前は、Service://HostName/ Path という形式の URL を含む IA5 文字列です。
CERT_ALT_NAME_OTHER_NAME	名前は、オブジェクト識別子 (OID) とバイナリ BLOB で構成されます。

[in] strName

代替名を指定します。

メソッドが成功した場合、メソッドは S_OKを返します。

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