CHttpFile::SendRequestEx

Artigo
08/25/2010

telefonar Essa função de membro para enviar uma solicitação para um 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 a serem enviados na solicitação.
dwFlags
Sinalizadores de descrever a operação.Para obter uma lista dos sinalizadores apropriados, consulte HttpSendRequestEx in the Windows SDK*.*
dwContext
O identificador de contexto para o CHttpFile operação. Para obter mais informações sobre esse parâmetro, consulte comentários.
lpBuffIn
Ponteiro para um inicializado INTERNET_BUFFERS que descreve o buffer de entrada usado para a operação.
lpBuffOut
Ponteiro para um inicializado INTERNET_BUFFERS que descreve o buffer de saída usado para a operação.

Valor de retorno

Diferente de zero se bem-sucedida; caso contrário, 0.Se a telefonar falhar, determinar a causa da falha, examinando o geradas CInternetException objeto.

Comentários

Essa função permite que seu aplicativo enviar dados usando o gravar and WriteString métodos para CInternetFile. Você deve saber o tamanho dos dados para enviar antes de chamar qualquer substituir dessa função.A primeira substituir permite que você especifique o comprimento dos dados que você gostaria de enviar.A segunda substituir aceita ponteiros para INTERNET_BUFFERS estruturas, que podem ser usadas para descrever o buffer em detalhes.

Depois que conteúdo é gravado no arquivo, telefonar EndRequest para finalizar a operação.

O valor padrão de dwContext é enviada pelo MFC para o CHttpFile objeto das CInternetSession objeto que criou o CHttpFile objeto. Quando você chama CInternetSession::OpenURL or CHttpConnection para construir um CHttpFile objeto que você pode substituir o padrão para conjunto o identificador de contexto com um valor de sua escolha. O identificador de contexto é retornado para CInternetSession::OnStatusCallback para fornecer status sobre o objeto ao qual ela é identificada.Consulte o artigo Internet etapas primeira: WinInet para obter mais informações sobre o identificador de contexto.

Exceções

Esse método pode lançar exceções do tipo CInternetException*.

Exemplo

Este fragmento de código envia o conteúdo de uma seqüência de caracteres para uma DLL chamada MFCISAPI.DLL no servidor de LOCALHOST.Enquanto este exemplo usa apenas uma telefonar para WriteString, o uso de várias chamadas para enviar dados em blocos é aceitável.

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();