CHttpFile::SendRequestEx

Articolo
03/05/2013

Chiamare la funzione membro per inviare una richiesta a un server 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 
);

Parametri

dwTotalLen
Numero di byte da inserire la richiesta.
dwFlags
Flag che descrivono l'operazione.Per un elenco dei flag appropriati, vedere HttpSendRequestEx in Windows SDK*.*
dwContext
l'identificatore di contesto per l'operazione CHttpFile.Vedere le note per ulteriori informazioni su questo parametro.
lpBuffIn
Il puntatore a INTERNET_BUFFERS inizializzato che descrive il buffer di input ha impiegato per l'operazione.
lpBuffOut
Il puntatore a INTERNET_BUFFERS inizializzato che descrive il buffer di output utilizzato per l'operazione.

Valore restituito

Diverso da zero se ha esito positivo.Se la chiamata ha esito negativo, determinare la causa dell'errore dall'analisi dell'oggetto generato CInternetException.

Note

Questa funzione consente l'applicazione inviare i dati utilizzando i metodi WriteString e ScrivereCInternetFile.È necessario conoscere la lunghezza dei dati per inviare prima di chiamare qualsiasi override della funzione.Le prime override consentono di specificare la lunghezza dei dati si desidera inviare.La seconda override accettano puntatori alle strutture INTERNET_BUFFERS, che possono essere utilizzate per descrivere il buffer nei minimi particolari.

Dopo che il contenuto è scritto nel file, chiamata EndRequest terminare l'operazione.

Il valore predefinito per dwContext viene inviato da MFCoggetto CHttpFile dall'oggetto CInternetSession che ha creato l'oggetto CHttpFile.Quando si chiama CInternetSession::OpenURL o CHttpConnection per creare un oggetto CHttpFile, è possibile ignorare l'impostazione predefinita per impostare l'identificatore di contesto a un valore desiderato.L'identificatore di contesto viene restituito a CInternetSession::OnStatusCallback per fornire lo stato dell'oggetto con cui viene identificato.Vedere l'articolo Primi passaggi Internet: WinInet per ulteriori informazioni sull'identificatore di contesto.

Eccezioni

Questo metodo può generare eccezioni di tipo CInternetException*.

Esempio

Nel frammento di codice invia il contenuto di una stringa a una DLL denominato MFCISAPI.DLL nel server di LOCALHOST.Sebbene questo esempio utilizza solo una chiamata a WriteString, utilizzando chiamate più inviare dati in blocchi è accettabile.

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