IXMLHTTPRequest2::SetProperty 메서드(msxml6.h)

  • 아티클

나가는 HTTP 요청에 대한 속성을 설정합니다.

구문

HRESULT SetProperty(
  [in] XHR_PROPERTY eProperty,
  [in] ULONGLONG    ullValue
);

매개 변수

[in] eProperty

유효한 값은 다음과 같습니다.

값 의미
XHR_PROP_NO_CRED_PROMPT
 사용자 자격 증명에 대한 자동 프롬프트를 표시하지 않습니다.
XHR_PROP_NO_AUTH
 HTTP 스택이 애플리케이션을 대신하여 수행하는 인증을 표시하지 않습니다.
XHR_PROP_TIMEOUT
 모든 시간 제한 값을 ullValue에서 지정한 값(밀리초)으로 설정합니다.
XHR_PROP_NO_DEFAULT_HEADERS
 HTTP 요청에 기본 헤더 추가를 표시하지 않습니다.
XHR_PROP_REPORT_REDIRECT_STATUS
 중간 리디렉션 상태 코드를 사용하여 HTTP 스택이 OnHeadersAvailable 메서드를 호출하도록 합니다. 추가 리디렉션 및 최종 대상 상태 코드에 대해 OnHeadersAvailable 메서드가 다시 호출됩니다.
XHR_PROP_NO_CACHE
 HTTP 요청에 대한 캐시 읽기 및 쓰기를 표시하지 않습니다.

이 속성은 IXMLHTTPRequest3 인터페이스에서 지원됩니다.
XHR_PROP_EXTENDED_ERROR
 HTTP 스택이 오류 발생 시 기본 Win32 오류 코드를 OnError 메서드에 HRESULTS에 제공하도록 합니다.

이 속성은 IXMLHTTPRequest3 인터페이스에서 지원됩니다.
XHR_PROP_QUERY_STRING_UTF8
쿼리 문자열이 HTTP 요청에 대한 ACP 대신 UTF-8로 인코딩되도록 합니다.

이 속성은 IXMLHTTPRequest3 인터페이스에서 지원됩니다.
XHR_PROP_IGNORE_CERT_ERRORS
 특정 인증서 오류를 표시하지 않습니다.

이 속성은 IXMLHTTPRequest3 인터페이스에서 지원됩니다.

[in] ullValue

애플리케이션이 시간 초과 전에 대기하는 시간(밀리초)을 지정합니다.

값 의미
XHR_PROP_NO_CRED_PROMPT
 이 매개 변수는 Msxml6.h 헤더 파일에 정의된 XHR_CRED_PROMPT 열거형 형식의 값 중 하나일 수 있습니다.
  • 자격 증명 프롬프트를 사용하도록 설정해야 하는 경우 (기본값) XHR_CRED_PROMPT_ALL.
  • 자격 증명 프롬프트를 사용하지 않도록 설정해야 하는 경우 XHR_CRED_PROMPT_NONE.
  • 자격 증명 프롬프트를 프록시 인증에 대해서만 사용하도록 설정해야 하는 경우 XHR_CRED_PROMPT_PROXY.
XHR_PROP_NO_AUTH
 이 매개 변수는 Msxml6.h 헤더 파일에 정의된 XHR_AUTH 열거형 형식의 값 중 하나일 수 있습니다.
  • XHR_AUTH_ALL 인증을 사용하는 경우(기본값)
  • 인증을 사용하지 않도록 설정된 경우 XHR_AUTH_NONE.
  • 프록시 인증에 대해서만 인증을 사용하도록 설정해야 하는 경우 XHR_AUTH_PROXY.
XHR_PROP_TIMEOUT
앱이 시간 초과 전에 대기하는 최대 0xFFFFFFFF 시간(밀리초)입니다.
XHR_PROP_NO_DEFAULT_HEADERS
  • 기본 헤더( 기본값)를 추가할 수 있도록 하는 FALSE(0x0)입니다.
  • 기본 헤더 추가를 사용하지 않도록 설정하는 TRUE(0x1)입니다.
XHR_PROP_REPORT_REDIRECT_STATUS
  • 리디렉션 상태 보고하지 않는 FALSE(0x0)입니다(기본값).
  • 리디렉션 상태 보고하는 TRUE(0x1)입니다.
XHR_PROP_NO_CACHE
  • 캐싱을 사용하도록 설정하는 FALSE(0x0 )입니다(기본값).
  • TRUE(0x1)를 사용하여 캐싱을 사용하지 않도록 설정합니다.
XHR_PROP_EXTENDED_ERROR
  • 확장 오류 (기본값)를 제공하지 않는 FALSE(0x0)입니다.
  • TRUE(0x1)를 사용하여 확장 오류를 제공합니다.
XHR_PROP_QUERY_STRING_UTF8
  • UTF-8 (기본값)에서 쿼리 문자열을 인코딩하지 않는 FALSE(0x0)입니다.
  • UTF-8에서 쿼리 문자열을 인코딩하는 TRUE(0x1)입니다.
XHR_PROP_IGNORE_CERT_ERRORS
  • 인증서 오류를 무시하지 않는 FALSE (0x0)입니다(기본값).
  • 인증서 오류를 무시하려면 TRUE(0x1)입니다.

반환 값

성공하면 S_OK를 반환합니다.

설명

IXMLHTTPRequest2 인터페이스의 SetProperty 메서드는 새 시나리오를 지원하기 위해 새 속성을 사용하여 IXMLHTTPRequest3 인터페이스에서 확장됩니다.

  • XHR_PROP_NO_CACHE – HTTP 요청에 대한 캐시 읽기 및 쓰기를 표시하지 않습니다.
  • XHR_PROP_EXTENDED_ERROR – HTTP 스택이 오류 발생 시 기본 Win32 오류 코드를 OnError 메서드에 HRESULTS에 제공하도록 합니다.
  • XHR_PROP_QUERY_STRING_UTF8 – 쿼리 문자열이 HTTP 요청에 대한 ACP 대신 UTF-8로 인코딩되도록 합니다.
  • XHR_PROP_IGNORE_CERT_ERRORS – 특정 서버 인증서 오류를 표시하지 않습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱 | UWP 앱],MSXML 6.0 이상
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 msxml6.h

추가 정보

IXMLHTTPRequest2

IXMLHTTPRequest3

OnHeadersAvailable

열기

XHR_PROPERTY 열거형