core/UserMessages.cpp
author David Anderson <dvander@alliedmods.net>
Wed Aug 01 02:12:47 2007 +0000 (2007-08-01)
changeset 1231 17badaf66ce4
parent 1132 e8d4e82e9541
child 1250 8241c207b514
permissions -rw-r--r--
updated more header files (mostly internal now)
dvander@592
     1
/**
ds@653
     2
 * vim: set ts=4 :
dvander@1231
     3
 * ================================================================
dvander@1231
     4
 * SourceMod
dvander@1231
     5
 * Copyright (C) 2004-2007 AlliedModders LLC.  All rights reserved.
dvander@1231
     6
 * ================================================================
ds@653
     7
 *
dvander@1231
     8
 * This program is free software; you can redistribute it and/or 
dvander@1231
     9
 * modify it under the terms of the GNU General Public License, 
dvander@1231
    10
 * version 3.0, as published by the Free Software Foundation.
dvander@1231
    11
 * 
dvander@1231
    12
 * This program is distributed in the hope that it will be useful,
dvander@1231
    13
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
dvander@1231
    14
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
dvander@1231
    15
 * GNU General Public License for more details.
dvander@1231
    16
 *
dvander@1231
    17
 * You should have received a copy of the GNU General Public License
dvander@1231
    18
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
dvander@1231
    19
 *
dvander@1231
    20
 * As a special exception, AlliedModders LLC gives you permission to 
dvander@1231
    21
 * link the code of this program (as well as its derivative works) to 
dvander@1231
    22
 * "Half-Life 2," the "Source Engine," the "SourcePawn JIT," and any 
dvander@1231
    23
 * Game MODs that run on software by the Valve Corporation.  You must 
dvander@1231
    24
 * obey the GNU General Public License in all respects for all other 
dvander@1231
    25
 * code used. Additionally, AlliedModders LLC grants this exception 
dvander@1231
    26
 * to all derivative works. AlliedModders LLC defines further 
dvander@1231
    27
 * exceptions, found in LICENSE.txt (as of this writing, version 
dvander@1231
    28
 * JULY-31-2007), or <http://www.sourcemod.net/license.php>.
ds@653
    29
 *
ds@653
    30
 * Version: $Id$
ds@653
    31
 */
dvander@592
    32
dvander@592
    33
#include "UserMessages.h"
ds@765
    34
#include "sm_stringutil.h"
dvander@592
    35
dvander@616
    36
UserMessages g_UserMsgs;
dvander@592
    37
dvander@592
    38
SH_DECL_HOOK2(IVEngineServer, UserMessageBegin, SH_NOATTRIB, 0, bf_write *, IRecipientFilter *, int);
dvander@592
    39
SH_DECL_HOOK0_void(IVEngineServer, MessageEnd, SH_NOATTRIB, 0);
dvander@592
    40
dvander@616
    41
UserMessages::UserMessages() : m_InterceptBuffer(m_pBase, 2500)
dvander@592
    42
{
dvander@592
    43
	m_Names = sm_trie_create();
dvander@592
    44
	m_HookCount = 0;
dvander@592
    45
	m_InExec = false;
dvander@592
    46
	m_InHook = false;
dvander@592
    47
	m_CurFlags = 0;
dvander@592
    48
	m_CurId = INVALID_MESSAGE_ID;
dvander@592
    49
}
dvander@592
    50
dvander@616
    51
UserMessages::~UserMessages()
dvander@592
    52
{
dvander@592
    53
	sm_trie_destroy(m_Names);
faluco@641
    54
faluco@641
    55
	CStack<ListenerInfo *>::iterator iter;
faluco@641
    56
	for (iter=m_FreeListeners.begin(); iter!=m_FreeListeners.end(); iter++)
faluco@641
    57
	{
faluco@641
    58
		delete (*iter);
faluco@641
    59
	}
faluco@641
    60
	m_FreeListeners.popall();
dvander@592
    61
}
dvander@592
    62
ds@765
    63
void UserMessages::OnSourceModStartup(bool late)
ds@765
    64
{
ds@765
    65
	/* -1 means SourceMM was unable to get the user message list */
ds@765
    66
	m_FallbackSearch = (g_SMAPI->GetUserMessageCount() == -1);
ds@765
    67
}
ds@765
    68
dvander@616
    69
void UserMessages::OnSourceModAllInitialized()
dvander@592
    70
{
dvander@592
    71
	g_ShareSys.AddInterface(NULL, this);
dvander@592
    72
}
dvander@592
    73
dvander@616
    74
void UserMessages::OnSourceModAllShutdown()
dvander@592
    75
{
dvander@592
    76
	if (m_HookCount)
dvander@592
    77
	{
dvander@616
    78
		SH_REMOVE_HOOK_MEMFUNC(IVEngineServer, UserMessageBegin, engine, this, &UserMessages::OnStartMessage_Pre, false);
dvander@616
    79
		SH_REMOVE_HOOK_MEMFUNC(IVEngineServer, UserMessageBegin, engine, this, &UserMessages::OnStartMessage_Post, true);
dvander@616
    80
		SH_REMOVE_HOOK_MEMFUNC(IVEngineServer, MessageEnd, engine, this, &UserMessages::OnMessageEnd_Pre, false);
dvander@616
    81
		SH_REMOVE_HOOK_MEMFUNC(IVEngineServer, MessageEnd, engine, this, &UserMessages::OnMessageEnd_Post, true);
dvander@592
    82
	}
dvander@592
    83
	m_HookCount = 0;
dvander@592
    84
}
dvander@592
    85
dvander@616
    86
int UserMessages::GetMessageIndex(const char *msg)
dvander@592
    87
{
dvander@592
    88
	int msgid;
ds@698
    89
dvander@592
    90
	if (!sm_trie_retrieve(m_Names, msg, reinterpret_cast<void **>(&msgid)))
dvander@592
    91
	{
ds@765
    92
		if (m_FallbackSearch)
ds@765
    93
		{
ds@765
    94
			char msgbuf[64];
ds@765
    95
			int size;
ds@765
    96
			msgid = 0;
ds@765
    97
ds@765
    98
			while (gamedll->GetUserMessageInfo(msgid, msgbuf, sizeof(msgbuf), size))
ds@765
    99
			{
ds@765
   100
				if (strcmp(msgbuf, msg) == 0)
ds@765
   101
				{
ds@765
   102
					sm_trie_insert(m_Names, msg, reinterpret_cast<void *>(msgid));
ds@765
   103
					return msgid;
ds@765
   104
				}
ds@765
   105
				msgid++;
ds@765
   106
			}
ds@765
   107
		}
ds@765
   108
ds@698
   109
		msgid = g_SMAPI->FindUserMessage(msg);
dvander@592
   110
ds@698
   111
		if (msgid != INVALID_MESSAGE_ID)
dvander@592
   112
		{
ds@698
   113
			sm_trie_insert(m_Names, msg, reinterpret_cast<void *>(msgid));
dvander@592
   114
		}
dvander@592
   115
	}
dvander@592
   116
dvander@592
   117
	return msgid;
dvander@592
   118
}
dvander@592
   119
ds@765
   120
bool UserMessages::GetMessageName(int msgid, char *buffer, size_t maxlength) const
ds@765
   121
{
ds@765
   122
	if (m_FallbackSearch)
ds@765
   123
	{
ds@765
   124
		int size;
ds@765
   125
		return gamedll->GetUserMessageInfo(msgid, buffer, maxlength, size);
ds@765
   126
	}
ds@766
   127
ds@765
   128
	const char *msg = g_SMAPI->GetUserMessage(msgid);
ds@765
   129
ds@765
   130
	if (msg)
ds@765
   131
	{
ds@765
   132
		strncopy(buffer, msg, maxlength);
ds@765
   133
		return true;
ds@765
   134
	}
ds@765
   135
ds@765
   136
	return false;
ds@765
   137
}
ds@765
   138
dvander@616
   139
bf_write *UserMessages::StartMessage(int msg_id, cell_t players[], unsigned int playersNum, int flags)
dvander@592
   140
{
dvander@592
   141
	bf_write *buffer;
faluco@593
   142
faluco@593
   143
	if (m_InExec || m_InHook)
dvander@592
   144
	{
dvander@592
   145
		return NULL;
dvander@592
   146
	}
dvander@592
   147
	if (msg_id < 0 || msg_id >= 255)
dvander@592
   148
	{
dvander@592
   149
		return NULL;
dvander@592
   150
	}
dvander@592
   151
faluco@593
   152
	m_CellRecFilter.Initialize(players, playersNum);
dvander@592
   153
dvander@592
   154
	m_CurFlags = flags;
dvander@592
   155
	if (m_CurFlags & USERMSG_INITMSG)
dvander@592
   156
	{
faluco@593
   157
		m_CellRecFilter.SetToInit(true);
dvander@592
   158
	}
dvander@592
   159
	if (m_CurFlags & USERMSG_RELIABLE)
dvander@592
   160
	{
faluco@593
   161
		m_CellRecFilter.SetToReliable(true);
dvander@592
   162
	}
dvander@592
   163
dvander@592
   164
	m_InExec = true;
dvander@592
   165
dvander@592
   166
	if (m_CurFlags & (USERMSG_PASSTHRU_ALL|USERMSG_PASSTHRU))
dvander@592
   167
	{
dvander@592
   168
		buffer = engine->UserMessageBegin(static_cast<IRecipientFilter *>(&m_CellRecFilter), msg_id);
dvander@592
   169
	} else {
dvander@592
   170
		buffer = ENGINE_CALL(UserMessageBegin)(static_cast<IRecipientFilter *>(&m_CellRecFilter), msg_id);
dvander@592
   171
	}
dvander@592
   172
dvander@592
   173
	return buffer;
dvander@592
   174
}
dvander@592
   175
dvander@616
   176
bool UserMessages::EndMessage()
dvander@592
   177
{
dvander@592
   178
	if (!m_InExec)
dvander@592
   179
	{
dvander@592
   180
		return false;
dvander@592
   181
	}
dvander@592
   182
dvander@592
   183
	if (m_CurFlags & (USERMSG_PASSTHRU_ALL|USERMSG_PASSTHRU))
dvander@592
   184
	{
dvander@592
   185
		engine->MessageEnd();
dvander@592
   186
	} else {
dvander@592
   187
		ENGINE_CALL(MessageEnd)();
dvander@592
   188
	}
dvander@592
   189
dvander@592
   190
	m_InExec = false;
dvander@592
   191
	m_CurFlags = 0;
faluco@593
   192
	m_CellRecFilter.Reset();
dvander@592
   193
dvander@592
   194
	return true;
dvander@592
   195
}
dvander@592
   196
dvander@616
   197
bool UserMessages::HookUserMessage(int msg_id, IUserMessageListener *pListener, bool intercept)
dvander@592
   198
{
dvander@592
   199
	if (msg_id < 0 || msg_id >= 255)
dvander@592
   200
	{
dvander@592
   201
		return false;
dvander@592
   202
	}
dvander@592
   203
faluco@593
   204
	ListenerInfo *pInfo;
faluco@593
   205
	if (m_FreeListeners.empty())
faluco@593
   206
	{
faluco@593
   207
		pInfo = new ListenerInfo;
faluco@593
   208
	} else {
faluco@593
   209
		pInfo = m_FreeListeners.front();
faluco@593
   210
		m_FreeListeners.pop();
faluco@593
   211
	}
faluco@593
   212
faluco@593
   213
	pInfo->Callback = pListener;
faluco@593
   214
	pInfo->IsHooked = false;
faluco@593
   215
	pInfo->KillMe = false;
faluco@593
   216
dvander@592
   217
	if (!m_HookCount++)
dvander@592
   218
	{
dvander@616
   219
		SH_ADD_HOOK_MEMFUNC(IVEngineServer, UserMessageBegin, engine, this, &UserMessages::OnStartMessage_Pre, false);
dvander@616
   220
		SH_ADD_HOOK_MEMFUNC(IVEngineServer, UserMessageBegin, engine, this, &UserMessages::OnStartMessage_Post, true);
dvander@616
   221
		SH_ADD_HOOK_MEMFUNC(IVEngineServer, MessageEnd, engine, this, &UserMessages::OnMessageEnd_Pre, false);
dvander@616
   222
		SH_ADD_HOOK_MEMFUNC(IVEngineServer, MessageEnd, engine, this, &UserMessages::OnMessageEnd_Post, true);
dvander@592
   223
	}
dvander@592
   224
dvander@592
   225
	if (intercept)
dvander@592
   226
	{
faluco@593
   227
		m_msgIntercepts[msg_id].push_back(pInfo);
dvander@592
   228
	} else {
faluco@593
   229
		m_msgHooks[msg_id].push_back(pInfo);
dvander@592
   230
	}
dvander@592
   231
dvander@592
   232
	return true;
dvander@592
   233
}
dvander@592
   234
dvander@616
   235
bool UserMessages::UnhookUserMessage(int msg_id, IUserMessageListener *pListener, bool intercept)
faluco@593
   236
{	
faluco@593
   237
	MsgList *pList;
dvander@592
   238
	MsgIter iter;
faluco@593
   239
	ListenerInfo *pInfo;
dvander@592
   240
	bool deleted = false;
dvander@592
   241
dvander@592
   242
	if (msg_id < 0 || msg_id >= 255)
dvander@592
   243
	{
dvander@592
   244
		return false;
dvander@592
   245
	}
dvander@592
   246
faluco@593
   247
	pList = (intercept) ? &m_msgIntercepts[msg_id] : &m_msgHooks[msg_id];
faluco@593
   248
	for (iter=pList->begin(); iter!=pList->end(); iter++)
dvander@592
   249
	{
faluco@593
   250
		pInfo = (*iter);
faluco@593
   251
		if (pInfo->Callback == pListener)
dvander@592
   252
		{
faluco@593
   253
			if (pInfo->IsHooked)
faluco@593
   254
			{
faluco@593
   255
				pInfo->KillMe = true;
faluco@593
   256
				return true;
faluco@593
   257
			}
faluco@593
   258
			pList->erase(iter);
dvander@592
   259
			deleted = true;
dvander@592
   260
			break;
dvander@592
   261
		}
dvander@592
   262
	}
dvander@592
   263
faluco@593
   264
	if (deleted)
faluco@593
   265
	{
faluco@593
   266
		_DecRefCounter();
faluco@593
   267
	}
faluco@593
   268
faluco@593
   269
	return deleted;
faluco@593
   270
}
faluco@593
   271
dvander@616
   272
void UserMessages::_DecRefCounter()
faluco@593
   273
{
faluco@593
   274
	if (--m_HookCount == 0)
dvander@592
   275
	{
dvander@616
   276
		SH_REMOVE_HOOK_MEMFUNC(IVEngineServer, UserMessageBegin, engine, this, &UserMessages::OnStartMessage_Pre, false);
dvander@616
   277
		SH_REMOVE_HOOK_MEMFUNC(IVEngineServer, UserMessageBegin, engine, this, &UserMessages::OnStartMessage_Post, true);
dvander@616
   278
		SH_REMOVE_HOOK_MEMFUNC(IVEngineServer, MessageEnd, engine, this, &UserMessages::OnMessageEnd_Pre, false);
dvander@616
   279
		SH_REMOVE_HOOK_MEMFUNC(IVEngineServer, MessageEnd, engine, this, &UserMessages::OnMessageEnd_Post, true);
dvander@592
   280
	}
dvander@592
   281
}
dvander@592
   282
dvander@616
   283
bf_write *UserMessages::OnStartMessage_Pre(IRecipientFilter *filter, int msg_type)
dvander@592
   284
{
dvander@592
   285
	bool is_intercept_empty = m_msgIntercepts[msg_type].empty();
dvander@592
   286
	bool is_hook_empty = m_msgHooks[msg_type].empty();
dvander@592
   287
faluco@593
   288
	if ((is_intercept_empty && is_hook_empty)
faluco@593
   289
		|| (m_InExec && !(m_CurFlags & USERMSG_PASSTHRU_ALL)))
dvander@592
   290
	{
dvander@592
   291
		m_InHook = false;
dvander@592
   292
		RETURN_META_VALUE(MRES_IGNORED, NULL);
dvander@592
   293
	}
dvander@592
   294
dvander@592
   295
	m_CurId = msg_type;
dvander@592
   296
	m_CurRecFilter = filter;
dvander@592
   297
	m_InHook = true;
faluco@597
   298
	m_BlockEndPost = false;
dvander@592
   299
dvander@592
   300
	if (!is_intercept_empty)
dvander@592
   301
	{
faluco@593
   302
		m_InterceptBuffer.Reset();
dvander@592
   303
		RETURN_META_VALUE(MRES_SUPERCEDE, &m_InterceptBuffer);
dvander@592
   304
	}
dvander@592
   305
dvander@592
   306
	RETURN_META_VALUE(MRES_IGNORED, NULL);
dvander@592
   307
}
dvander@592
   308
dvander@616
   309
bf_write *UserMessages::OnStartMessage_Post(IRecipientFilter *filter, int msg_type)
dvander@592
   310
{
dvander@592
   311
	if (!m_InHook)
dvander@592
   312
	{
dvander@592
   313
		RETURN_META_VALUE(MRES_IGNORED, NULL);
dvander@592
   314
	}
dvander@592
   315
dvander@592
   316
	m_OrigBuffer = META_RESULT_ORIG_RET(bf_write *);
dvander@592
   317
dvander@592
   318
	RETURN_META_VALUE(MRES_IGNORED, NULL);
dvander@592
   319
}
dvander@592
   320
dvander@616
   321
void UserMessages::OnMessageEnd_Post()
dvander@592
   322
{
faluco@597
   323
	if (!m_InHook || m_BlockEndPost)
dvander@592
   324
	{
dvander@592
   325
		RETURN_META(MRES_IGNORED);
dvander@592
   326
	}
dvander@592
   327
faluco@593
   328
	MsgList *pList;
dvander@592
   329
	MsgIter iter;
faluco@593
   330
	ListenerInfo *pInfo;
faluco@593
   331
faluco@593
   332
	pList = &m_msgIntercepts[m_CurId];
faluco@593
   333
	for (iter=pList->begin(); iter!=pList->end(); )
faluco@593
   334
	{
faluco@593
   335
		pInfo = (*iter);
faluco@593
   336
		pInfo->IsHooked = true;
faluco@593
   337
		pInfo->Callback->OnUserMessageSent(m_CurId);
dvander@592
   338
faluco@593
   339
		if (pInfo->KillMe)
faluco@593
   340
		{
faluco@593
   341
			iter = pList->erase(iter);
faluco@593
   342
			m_FreeListeners.push(pInfo);
faluco@593
   343
			_DecRefCounter();
faluco@593
   344
			continue;
faluco@593
   345
		}
faluco@593
   346
faluco@593
   347
		pInfo->IsHooked = false;
faluco@593
   348
		iter++;
dvander@592
   349
	}
dvander@592
   350
dvander@1132
   351
	m_InHook = false;
dvander@1132
   352
faluco@593
   353
	pList = &m_msgHooks[m_CurId];
faluco@594
   354
	for (iter=pList->begin(); iter!=pList->end(); )
dvander@592
   355
	{
faluco@593
   356
		pInfo = (*iter);
faluco@594
   357
		pInfo->IsHooked = true;
faluco@593
   358
		pInfo->Callback->OnUserMessageSent(m_CurId);
faluco@593
   359
faluco@593
   360
		if (pInfo->KillMe)
faluco@593
   361
		{
faluco@593
   362
			iter = pList->erase(iter);
faluco@593
   363
			m_FreeListeners.push(pInfo);
faluco@593
   364
			_DecRefCounter();
faluco@593
   365
			continue;
faluco@593
   366
		}
faluco@593
   367
faluco@593
   368
		pInfo->IsHooked = false;
faluco@593
   369
		iter++;
dvander@592
   370
	}
dvander@592
   371
}
dvander@592
   372
dvander@616
   373
void UserMessages::OnMessageEnd_Pre()
dvander@592
   374
{
dvander@592
   375
	if (!m_InHook)
dvander@592
   376
	{
dvander@592
   377
		RETURN_META(MRES_IGNORED);
dvander@592
   378
	}
dvander@592
   379
faluco@593
   380
	MsgList *pList;
dvander@592
   381
	MsgIter iter;
faluco@593
   382
	ListenerInfo *pInfo;
faluco@593
   383
dvander@592
   384
	ResultType res;
dvander@592
   385
	bool intercepted = false;
dvander@592
   386
	bool handled = false;
dvander@592
   387
faluco@593
   388
	pList = &m_msgIntercepts[m_CurId];
faluco@593
   389
	for (iter=pList->begin(); iter!=pList->end(); )
dvander@592
   390
	{
faluco@593
   391
		pInfo = (*iter);
faluco@593
   392
		pInfo->IsHooked = true;
faluco@593
   393
		res = pInfo->Callback->InterceptUserMessage(m_CurId, &m_InterceptBuffer, m_CurRecFilter);
faluco@593
   394
faluco@597
   395
		intercepted = true;
faluco@597
   396
faluco@593
   397
		switch (res)
dvander@592
   398
		{
faluco@593
   399
		case Pl_Stop:
faluco@593
   400
			{
faluco@593
   401
				if (pInfo->KillMe)
faluco@593
   402
				{
faluco@593
   403
					pList->erase(iter);
faluco@593
   404
					m_FreeListeners.push(pInfo);
faluco@593
   405
					_DecRefCounter();
faluco@593
   406
					goto supercede;
faluco@593
   407
				}
faluco@593
   408
				pInfo->IsHooked = false;
faluco@593
   409
				goto supercede;
faluco@593
   410
			}
faluco@593
   411
		case Pl_Handled:
faluco@593
   412
			{
faluco@593
   413
				handled = true;
faluco@593
   414
				if (pInfo->KillMe)
faluco@593
   415
				{
faluco@593
   416
					iter = pList->erase(iter);
faluco@593
   417
					m_FreeListeners.push(pInfo);
faluco@593
   418
					_DecRefCounter();
faluco@593
   419
					continue;
faluco@593
   420
				}
faluco@593
   421
				break;
faluco@593
   422
			}
faluco@593
   423
		default:
faluco@593
   424
			{
faluco@593
   425
				if (pInfo->KillMe)
faluco@593
   426
				{
faluco@593
   427
					iter = pList->erase(iter);
faluco@593
   428
					m_FreeListeners.push(pInfo);
faluco@593
   429
					_DecRefCounter();
faluco@593
   430
					continue;
faluco@593
   431
				}
faluco@597
   432
				break;
faluco@593
   433
			}
dvander@592
   434
		}
faluco@593
   435
		pInfo->IsHooked = false;
faluco@593
   436
		iter++;
dvander@592
   437
	}
dvander@592
   438
dvander@592
   439
	if (handled)
dvander@592
   440
	{
dvander@592
   441
		goto supercede;
dvander@592
   442
	}
dvander@592
   443
dvander@592
   444
	if (intercepted)
dvander@592
   445
	{
faluco@593
   446
		bf_write *engine_bfw;
faluco@593
   447
dvander@592
   448
		engine_bfw = ENGINE_CALL(UserMessageBegin)(m_CurRecFilter, m_CurId);
dvander@592
   449
		m_ReadBuffer.StartReading(m_InterceptBuffer.GetBasePointer(), m_InterceptBuffer.GetNumBytesWritten());
dvander@592
   450
		engine_bfw->WriteBitsFromBuffer(&m_ReadBuffer, m_InterceptBuffer.GetNumBitsWritten());
dvander@592
   451
		ENGINE_CALL(MessageEnd)();
dvander@592
   452
	}
dvander@592
   453
faluco@593
   454
	pList = &m_msgHooks[m_CurId];
faluco@593
   455
	for (iter=pList->begin(); iter!=pList->end(); )
dvander@592
   456
	{
faluco@593
   457
		pInfo = (*iter);
faluco@593
   458
		pInfo->IsHooked = true;
faluco@593
   459
		pInfo->Callback->OnUserMessage(m_CurId, m_OrigBuffer, m_CurRecFilter);
faluco@593
   460
faluco@593
   461
		if (pInfo->KillMe)
faluco@593
   462
		{
faluco@593
   463
			iter = pList->erase(iter);
faluco@593
   464
			m_FreeListeners.push(pInfo);
faluco@593
   465
			_DecRefCounter();
faluco@593
   466
			continue;
faluco@593
   467
		}
faluco@593
   468
faluco@594
   469
		pInfo->IsHooked = false;
faluco@593
   470
		iter++;
dvander@592
   471
	}
dvander@592
   472
faluco@597
   473
	RETURN_META((intercepted) ? MRES_SUPERCEDE : MRES_IGNORED);
dvander@592
   474
supercede:
faluco@593
   475
	m_InHook = false;
faluco@597
   476
	m_BlockEndPost = true;
dvander@592
   477
	RETURN_META(MRES_SUPERCEDE);
dvander@592
   478
}