다음을 통해 공유


CHttpFile::AddRequestHeaders

하나를 추가 하려면이 멤버 함수를 호출 하거나 처리할 HTTP 요청에 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 
);

매개 변수

  • pstrHeaders
    헤더 또는 요청을 추가 하려면 머리글을 포함 하는 문자열에 대 한 포인터입니다.각 헤더는 CR/LF 쌍으로 종료 되어야 합니다.

  • dwFlags
    새 헤더의 의미를 수정합니다.다음 중 하나일 수 있습니다.

    • HTTP_ADDREQ_FLAG_COALESCE같은 이름의 플래그를 사용 하 여 첫 번째 헤더 다음 헤더를 추가 하려면 머리글을 병합 합니다.예를 들어, "수락: 텍스트 / *" 뒤에 "수락: 오디오 / *" 결과 단일 헤더 대형을 "수락: 텍스트 / *, 오디오 / *".결합 또는 별도 헤더를 전송 하는 요청 받은 데이터와 관련 하 여 일관 된 구성을 확인 하는 호출 응용 프로그램입니다.

    • HTTP_ADDREQ_FLAG_REPLACE현재 명시적으로 추가 하 고 제거를 수행 합니다.헤더 이름을 사용 하 여 현재 머리글을 제거 하 고 전체 값을 사용 하 여 새 머리글을 추가 합니다.헤더 값이 비어 있는 경우 머리글을 찾을 수 제거 됩니다.그렇지 않으면 빈 헤더 값 대체 됩니다.

    • HTTP_ADDREQ_FLAG_ADD_IF_NEW존재 하지 않는 경우에 있는 헤더를 추가 합니다.있는 경우 오류가 반환 됩니다.

    • HTTP_ADDREQ_FLAG_ADDREPLACE를 사용합니다.없는 경우에 헤더를 추가 합니다.

  • dwHeadersLen
    문자에서 길이를 pstrHeaders.-1 L이 다음에 있는 경우 pstrHeaders 0으로 끝나는 것으로 간주 됩니다 하 고 길이가 계산 됩니다.

  • str
    참조 하는 CString 요청 헤더 또는 추가할 헤더를 포함 하는 개체입니다.

반환 값

성공 하면 0이 아닌. 그렇지 않으면 0입니다.Win32 함수 호출이 실패 하면 GetLastError 오류 원인을 호출 될 수 있습니다.

설명

AddRequestHeaders헤더 추가, 자유 형식의 HTTP 요청에 대 한 핸들을 추가합니다.이 사용에 대 한 정확한 HTTP 서버로 보낸 요청을 세부적으로 제어 하는 복잡 한 클라이언트에서 사용 됩니다.

[!참고]

응용 프로그램에서 여러 헤더를 전달할 수 있습니다 pstrHeaders 또는 str 에 있는 AddRequestHeaders 호출을 사용 하 여 HTTP_ADDREQ_FLAG_ADD 또는 HTTP_ADDREQ_FLAG_ADD_IF_NEW.응용 프로그램을 제거 하거나 사용 하 여 헤더를 교체 하 려 할 때 HTTP_ADDREQ_FLAG_REMOVE 또는 HTTP_ADDREQ_FLAG_REPLACE, 하나의 헤더에 제공할 수 lpszHeaders.

요구 사항

헤더: afxinet.h

참고 항목

참조

CHttpFile 클래스

계층 구조 차트

CInternetFile 클래스