CHttpFile::AddRequestHeaders
Llame a esta función miembro para agregar uno o más encabezados de solicitud HTTP al identificador de la solicitud HTTP.
BOOL AddRequestHeaders(
LPCTSTR pstrHeaders,
DWORD dwFlags = HTTP_ADDREQ_FLAG_ADD_IF_NEW,
int dwHeadersLen = -1
);
BOOL AddRequestHeaders(
CString& str,
DWORD dwFlags = HTTP_ADDREQ_FLAG_ADD_IF_NEW
);
Parámetros
pstrHeaders
Un puntero a una cadena que contiene el los encabezados para anexar a la solicitud.Cada encabezado se debe terminar mediante un par de CARACTERES.dwFlags
modifica la semántica de los nuevos encabezados.Puede ser una de las siguientes:HTTP_ADDREQ_FLAG_COALESCE combina encabezados del mismo nombre, mediante el marcador para agregar el primer encabezado encontró el encabezado siguiente.Por ejemplo, “aceptar: text/*” seguido de “aceptan: audio/*” resultados en la formación de un solo encabezado “aceptan: text/*, audio/*”.Depende de la aplicación de llamada para garantizar un esquema cohesivo respecto a los datos recibidos por las solicitudes enviadas con unido o para separar encabezados.
HTTP_ADDREQ_FLAG_REPLACE realiza un quitar y lo agrega para reemplazar el encabezado actual.El nombre del encabezado se usará para quitar el encabezado actual, y el valor completo se utilizará para agregar el nuevo encabezado.Si el encabezado-valor está vacío y se encuentra el encabezado, se quita.Si no está vacío, se reemplaza el encabezado-valor.
HTTP_ADDREQ_FLAG_ADD_IF_NEW Solo agrega el encabezado si no existe.Si existe, se devuelve un error.
HTTP_ADDREQ_FLAG_ADD utilizado con REEMPLAZA.agrega el encabezado si no existe.
dwHeadersLen
Longitud, en caracteres, de pstrHeaders.Si es -1L, después pstrHeaders se supone cero-para se finaliza y se calcula la longitud.str
Una referencia a un objeto de CString que contiene el encabezado de solicitud o los encabezados que se van a agregar.
Valor devuelto
Distinto de cero si correctamente; si no 0.Si se produce un error en la llamada, la función GetLastError de Win32 se puede llamar para determinar la causa del error.
Comentarios
AddRequestHeaders anexa adicional, encabezados de libre-formato al identificador de la solicitud HTTP.Está pensado para usarse en los clientes sofisticados que necesitan un control detallado de la solicitud exacta envíe al servidor HTTP.
[!NOTA]
La aplicación puede pasar varios encabezados en pstrHeaders o str para una llamada a AddRequestHeaders mediante HTTP_ADDREQ_FLAG_ADD o HTTP_ADDREQ_FLAG_ADD_IF_NEW.Si la aplicación intenta quitar o reemplazar un encabezado mediante HTTP_ADDREQ_FLAG_REMOVE o HTTP_ADDREQ_FLAG_REPLACE, solo un encabezado se puede proporcionar en lpszHeaders.
Requisitos
encabezado: afxinet.h