tag_name
この属性を要求ハンドラのメソッドに適用し、タグ名に関連付けられた置換メソッドとして公開します。
[ tag_name(
name,
parse_func
) ]
パラメータ
name
このメソッドを呼び出す置換ヘッダーのタグ名を指定する文字列。parse_func (省略可能)
メソッドに渡された引数の解析に使用される関数の名前。
解説
この属性は、メソッドを置換メソッドとして分類するために使用されます。メソッドには、複数の tag_name 属性を設定できます。
parse_func が指定されている場合、解析関数には次のシグネチャが必要です。
HTTP_CODE parse_func(IAtlMemMgr* pMemoryManager, LPCSTR szArg, Type** ppArg);
置換メソッドには、対応する次のシグネチャが必要です。
HTTP_CODE methodFunc(Type* pArg);
parse_func が省略されている場合、メソッドには次のいずれかの形式のシグネチャが必要です。
HTTP_CODE MethodName();
HTTP_CODE MethodName(Type* pArg);
Type には、次の型のいずれかを指定できます。
型 |
解析アルゴリズム |
|---|---|
bool |
DefaultParseBool |
char |
DefaultParseString |
unsigned char |
DefaultParseUChar |
short |
DefaultParseShort |
unsigned short |
DefaultParseUShort |
int |
DefaultParseInt |
unsigned int |
DefaultParseUInt |
__int64 |
DefaultParseInt64 |
unsigned __int64 |
DefaultParseUInt64 |
double |
DefaultParseDouble |
float |
DefaultParseFloat |
この属性の使用は、メソッドがパラメータを持たないときは REPLACEMENT_METHOD_ENTRY マクロに一致します。また、メソッドがパラメータを持つときは REPLACEMENT_METHOD_ENTRY_EX マクロに一致します。
必要条件
属性コンテキスト
対象 |
メソッド |
複数回の適用 |
可 |
必要な属性 |
なし |
無効な属性 |
なし |
属性コンテキストの詳細については、「属性コンテキスト」を参照してください。
属性の必要条件
ヘッダー |
atlstencil.h |
プロジェクト |
EXE、DLL |
コンパイラ |
/D "_ATL_ATTRIBUTES" |
必要条件の項目の詳細については、「属性の必要条件」を参照してください。