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 |