WsGetHeaderAttributes 함수(webservices.h)

  • 아티클

이 함수는 ULONG 매개 변수를 판독기가 배치된 헤더 요소의 WS_HEADER_ATTRIBUTES 채웁니다. 메시지의 봉투 버전은 반환할 특성을 결정하는 데 사용됩니다.

구문

HRESULT WsGetHeaderAttributes(
  [in]           WS_MESSAGE    *message,
  [in]           WS_XML_READER *reader,
  [out]          ULONG         *headerAttributes,
  [in, optional] WS_ERROR      *error
);

매개 변수

[in] message

쿼리할 메시지를 포함하는 WS_MESSAGE 구조체에 대한 포인터입니다. 메시지의 이 봉투 버전은 일치하는 특성을 결정하는 데 사용됩니다. 메시지는 WS_MESSAGE_STATE_EMPTY 제외한 모든 상태에 있을 수 있습니다.

[in] reader

쿼리할 판독기를 가리키는 포인터입니다. WsCreateReader에서 반환된 유효한 WS_XML_READER 개체여야 하며 NULL일 수 없습니다.

[out] headerAttributes

성공하면 이 포인터에서 참조하는 값이 헤더 특성으로 설정됩니다.

[in, optional] error

함수가 실패할 경우 오류에 대한 추가 정보를 저장해야 하는 WS_ERROR 개체에 대한 포인터입니다.

반환 값

이 함수는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 설명
E_OUTOFMEMORY
 메모리가 부족합니다.
E_INVALIDARG
 하나 이상의 인수가 잘못되었습니다.
WS_E_INVALID_FORMAT
 입력 데이터가 예상 형식이 아니거나 예상 값이 없습니다.
기타 오류
이 함수는 위에 나열되지 않은 다른 오류를 반환할 수 있습니다.

설명

판독기는 헤더 요소를 가리키는 것으로 간주됩니다. XML 판독기 API를 사용하여 판독기를 적절하게 배치합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 webservices.h
라이브러리 WebServices.lib
DLL WebServices.dll