Расширения ISAPI

/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Name: GetHeaderValuePair

In: sHeader - string HTTP Header 
    nStart - integer search start location
    psName - pointer to name of header that is being sought 
    psValue - pointer to string that will be filled if 
                value found
    pnEnd - pointer to integer of the final search position  

Out: bool    true returned if the header was found, 
            false returned otherwise
Purpose:
        Searches through the HTTP header passed in for a 
        header value. Returns data about the search 
        parameters if found or not.
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
bool GetHeaderValuePair(const string &sHeader, 
                        const int &nStart, 
                        string *psName, 
                        string *psValue, 
                        int *pnEnd)
{
    const string sColon(":");

    //determine if header is a post header
    string::size_type idxColonPosition = nStart;

    //start looking at beginning 
    idxColonPosition = sHeader.find(sColon, idxColonPosition);

    if (idxColonPosition == string::npos)//no more headers found
        return false;//this is failure

    //get the name
    psName->assign(sHeader.substr
                   (nStart, idxColonPosition - nStart));

    //find next newline
    string::size_type idxNewLine;
    idxNewLine = sHeader.find('\n', idxColonPosition);

    //get the end even if it means not found
    *pnEnd = idxNewLine;

    if (idxNewLine == string::npos)    //a newline was not found
        return true;//not a failure - might be the last header

    //get the value
    //adjust colon position so we do not assign colon in value
    idxColonPosition = idxColonPosition +1; 
    psValue->assign(sHeader.substr(idxColonPosition, 
        idxNewLine - idxColonPosition));

    return true;

/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Name:GetECBElement

In:    pECB - Pointer to the extension control block for the 
    purposes of calling the GetServerVariable function.
    
    sName - string name of the server variable that is 
            being sought.

    psElement - string pointer to XML document being built that 
                will be updated with the name and value for the 
                server variable extracted from the extension 
                control block.

Out:    nothing returned but the string psElement points to 
        will be updated.

Purpose:
    appends a string of an XML element to the string psElement 
    points to. The XML element that is created is in the form of
<Server Variable Name>Server Variable Value</Server Variable Name>

    for example:
 <GATEWAY_INTERFACE>CGI/1.1</GATEWAY_INTERFACE> + newline

/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/    
void GetECBElement(    EXTENSION_CONTROL_BLOCK *pECB, 
                                    const string &sName, 
                                    string *psElement)
{

TCHAR szTempBuffer[BUFFER_LENGTH];
DWORD dwBufferSize = BUFFER_LENGTH;

    //get the server variable value
   if (pECB->GetServerVariable(    pECB->ConnID, 
                    (LPSTR)sName.c_str(), 
                    szTempBuffer, 
                    &dwBufferSize))
   {
       //build the XML element and 
       //add it to the XML document passed in
        psElement->append(string(XML_L) + sName + string(XML_R));

        psElement->append(ValidateValue((string)szTempBuffer));

        psElement->append(string(XML_L_END) + sName + string(XML_R) + 
            string(NEW_LINE));
   }

}

/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Name: ValidateValue

In: Constant reference to a string variable sValue. sValue is the 
    value being checked to see if it has a character requiring 
    escaping

Out: returns a string with the escaped characters in place

Purpose:
    blindly replaces all special characters 
    with the escape sequence character so that XML will
    be valid. 

/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
string ValidateValue(const string &sValue)
{
    string sReturn;
    sReturn = sValue;

    FindAndReplace(&sReturn, &string("&"),&string("&"));
    FindAndReplace(&sReturn, &string("="),&string("="));
    FindAndReplace(&sReturn, &string("<"),&string("&lt;"));
    FindAndReplace(&sReturn, &string(">"),&string("&gt;"));
    FindAndReplace(&sReturn, &string("'"),&string("&apos;"));
    FindAndReplace(&sReturn, &string("\""),&string("&quot;"));

    return sReturn;
}

/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Name: FindAndReplace

In: psContainer - pointer to a string that will be searched 
                  and edited if a value is discovered.
     psTarget - pointer to a string that is being sought for 
                replacement.
     psReplacement - pointer to a string that will replace the 
                     the string pointed to in psTarget.

Out: nothing - but psContainer will be changed

Purpose:
     searches string psContainer pointer for the string that 
     psTarget points to and replaces it with the string that 
     psReplacement points to.

/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
void FindAndReplace(string *psContainer, 
                         string *psTarget, 
                         string *psReplacement)
{

     string::size_type idx;
     idx = psContainer->find(*psTarget);
     while (idx != string::npos)//an instance was found
     {          
          //are we at the end of the string
          if (psContainer->size() == idx)
          {
               *psContainer += *psReplacement;
               break;
          }
          else
          {
               psContainer->replace
                         (idx, psTarget->size() , *psReplacement);
               
               //advance beyond the current character
               idx += psReplacement->size();
          }

          //look for next occurance
          idx = psContainer->find(*psTarget, idx);
     }

}

/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Name: SendResponse

In:    pECB - pointer to the extension control block
    sValue - string reference to the value to be
             written to the HTTP response

Out:    nothing

Purpose:
        writes the intended value to the HTTP response 
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
void SendResponse(EXTENSION_CONTROL_BLOCK *pECB, string &sValue)
{
    TCHAR szTempBuffer[BUFFER_LENGTH];
    DWORD dwBufferSize = BUFFER_LENGTH;

    // set content-type header
    strcpy(szTempBuffer, BASIC_HEADER);
    DWORD dwHeaderSize = strlen(szTempBuffer);
    pECB->ServerSupportFunction(pECB->ConnID, 
                                HSE_REQ_SEND_RESPONSE_HEADER, 
                                NULL, 
                                &dwHeaderSize, 
                                (LPDWORD) szTempBuffer);

    //write value to http response
    DWORD dwLength=sValue.length();
    pECB->WriteClient(    pECB->ConnID, 
                        (PVOID)sValue.c_str(), 
                        &dwLength, 
                        HSE_IO_SYNC);
}

BOOL WriteClient(
  HCONN ConnID,    
  LPVOID Buffer,   
  LPDWORD lpdwBytes, 
  DWORD dwSync   
);