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

아티클
03/05/2024

나가는 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::SetProperty 메서드(msxml6.h)

구문

매개 변수

반환 값

설명

요구 사항

추가 정보

피드백

추가 리소스