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

GetNameChoice メソッドは、代替名配列の指定したインデックス位置にある名前の選択を返します。

構文

HRESULT GetNameChoice(
  [in]  LONG NameIndex,
  [out] LONG *pNameChoice
);

[in] NameIndex

代替名エントリのインデックスを指定します。最初のエントリはインデックス 0 にあります。

[out] pNameChoice

名前選択指定子を受け取る LONG へのポインター。

メソッドが成功した場合、メソッドは S_OKを返し、 pNameChoice パラメーターは代替名の型を示す値を指します。これは次のいずれかの値です。

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

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

リターンコード	説明
CERT_ALT_NAME_DIRECTORY_NAME	名前はディレクトリ名です。
CERT_ALT_NAME_DNS_NAME	名前は、Host という形式の 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 で構成されます。