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