ON_PARSE_COMMAND

ON_PARSE_COMMAND( FnName, mapClass, Args )

Parameters

FnName

The name of the member function. Also the name of the command.

mapClass

The class name to map the function to.

Args

The arguments that map to the parameter’s FnName. See Remarks for a list of symbols.

Remarks

The ON_PARSE_COMMAND macro is used in a parse map to define a command to a CHttpServer object from a client.

The member function identified by FnName must take a pointer to the CHttpServerContext as its first parameter. FnName is of the type LPSTR, and is identified by the symbol ITS_LPSTR in the parse map; that is, FnName points to a string containing the member function in class mapClass.

The parameter Args can take one of the following values:

Symbol	Type or Comment
ITS_EMPTY	Args cannot be blank. Use ITS_EMPTY if you have no arguments.
ITS_PSTR	A pointer to a string.
ITS_RAW	The exact, raw data sent to the ISAPI extension. Do not use ITS_RAW with any other parameter type; to do so will cause an ASSERT. See Remarks for an example.
ITS_I2	a short
ITS_I4	a long
ITS_R4	a float
ITS_R8	a double

Examples

// The following  example Illustrates extracting
//  a string and a short sent to the server:

BEGIN_PARSE_MAP(CDerivedClass, CHttpServer)
   DEFAULT_PARSE_COMMAND(Myfunc, CDerivedClass)
   ON_PARSE_COMMAND(Myfunc, CDerivedClass, ITS_PSTR
    ITS_I2)
   ON_PARSE_COMMAND_PARAMS("string integer=42")
   ON_PARSE_COMMAND(Myfunc2, CDerivedClass, ITS_PSTR
    ITS_I2 ITS_PSTR)
   ON_PARSE_COMMAND_PARAMS("string integer
    string2='Default value'")
END_PARSE_MAP(CDerivedClass)

Note Use single quotes if you incorporate spaces into the default values for optional ITS_PSTRs.

void Myfunc(CHttpServerContext* pCtxt, LPTSTR pszName, int nNumber);
void Myfunc2(CHttpServerContext* pCtxt, LPTSTR pszName, int nNumber, LPTSTR pszTitle);


// The following  example Illustrates extracting 
// raw data sent to the server:

BEGIN_PARSE_MAP(CDerivedClass, CHttpServer)
   DEFAULT_PARSE_COMMAND(Myfunc, CDerivedClass)
   ON_PARSE_COMMAND(Myfunc, CDerivedClass, ITS_RAW)
END_PARSE_MAP(CDerivedClass)

with the function prototype as follows:

void CDerivedClass::Myfunc(CHttpServerContext* pCtxt, void* pVoid, DWORD dwBytes);

In the second example above, the pVoid pointer points to the data sent to your extension. The dwBytes parameter has a count of bytes at pVoid. If dwBytes is zero, pVoid may not point to anything.

Note The handlers for a parse map command must take a pointer to a CHttpServerContext as the first parameter, and the parameters must be declared in the same order in which they're defined in ON_PARSE_COMMAND.