CHttpFile::SendRequestEx

Artículo
02/19/2013

Llame a esta función miembro para enviar una solicitud a un servidor HTTP.

BOOL SendRequestEx(
   DWORD dwTotalLen,
   DWORD dwFlags = HSR_INITIATE,
   DWORD_PTR dwContext = 1 
);
BOOL SendRequestEx(
   LPINTERNET_BUFFERS lpBuffIn,
   LPINTERNET_BUFFERS lpBuffOut,
   DWORD dwFlags = HSR_INITIATE,
   DWORD_PTR dwContext = 1 
);

Parámetros

dwTotalLen
Número de bytes que se envían en la solicitud.
dwFlags
Marcas que describen la operación.Para obtener una lista de marcadores adecuados, vea HttpSendRequestEx en Windows SDK*.*
dwContext
El identificador del contexto de la operación de CHttpFile .Vea las notas para obtener información sobre este parámetro.
lpBuffIn
El puntero a INTERNET_BUFFERS inicializado que describe el búfer de entrada utilizados para la operación.
lpBuffOut
El puntero a INTERNET_BUFFERS inicializado que describe el búfer de salida utilizados para la operación.

Valor devuelto

Distinto de cero si correctamente.Si se produce un error en la llamada, determine la causa del error examinando el objeto iniciado de CInternetException .

Comentarios

Esta función permite a la aplicación para devolver datos mediante escritura y los métodos de WriteString de CInternetFile.Debe conocer la longitud de los datos para enviar antes de llamar a cualquier reemplazo de esta función.La primera reemplazo permite especificar la longitud de datos que desea enviar.La segunda reemplazo acepta punteros a las estructuras de INTERNET_BUFFERS , que se pueden usar para describir el búfer con gran detalle.

Cuando el contenido se escribe en el archivo, llamada EndRequest para finalizar la operación.

El valor predeterminado para dwContext es enviado por MFC al objeto de CHttpFile del objeto de CInternetSession que creó el objeto de CHttpFile .Cuando se llama a CInternetSession:: OpenURL o CHttpConnection para construir un objeto de CHttpFile , puede invalidar el valor predeterminado para establecer el identificador de contexto a un parámetro de elegir.El identificador de contexto se devuelve a CInternetSession:: OnStatusCallback para proporcionar el estado del objeto con el que se identifica.Vea el artículo Primeros pasos de internet: WinInet para obtener más información sobre el identificador del contexto.

Excepciones

Este método puede producir excepciones de **CInternetException***escrito.

Ejemplo

Este fragmento de código envía el contenido de una cadena en una DLL denominada MFCISAPI.DLL en el servidor de LOCALHOST.Aunque este ejemplo sólo utiliza una llamada a WriteString, utilizando varias llamadas enviar datos en bloques es aceptable.

CString strData = _T("Some very long data to be POSTed here!");
pServer = session.GetHttpConnection(_T("localhost"));
pFile = pServer->OpenRequest(CHttpConnection::HTTP_VERB_POST, 
   _T("/MFCISAPI/MFCISAPI.dll?"));
pFile->SendRequestEx(strData.GetLength());

pFile->WriteString(strData);   
pFile->EndRequest();