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

GetName メソッドは、代替名配列から指定された名前を返します。

構文

HRESULT GetName(
  [in]  LONG NameIndex,
  [out] BSTR *pstrName
);

パラメーター

[in] NameIndex

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

CERT_ALT_NAME_OTHER_NAME名の オブジェクト識別子 (OID) を取得するには、インデックス値をビットごとの OR 操作でEAN_NAMEOBJECTID (0x80000000として定義) と組み合わせます。 それ以外の場合は、バイナリ値が取得されます。 名前の種類を確認するには、 ICertEncodeAltName::GetNameChoice メソッドを 呼び出します。

[out] pstrName

代替名を受け取る BSTR へのポインター。 BSTR の使用が完了したら、SysFreeString 関数を呼び出して解放します。

戻り値

C++

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

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

VB

戻り値は、指定したインデックスの代替名です。 戻り値は Unicode 文字列です。

要件

要件
サポートされている最小のクライアント サポートなし
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー certenc.h (Certsrv.h を含む)
Library Certidl.lib
[DLL] Certenc.dll

こちらもご覧ください

ICertEncodeAltName

ICertEncodeAltName::GetNameChoice

ICertEncodeAltName::SetNameEntry