다음을 통해 공유

WsRemoveMappedHeader 함수(webservices.h)

  • 아티클

메시지에서 매핑된 헤더의 모든 인스턴스를 제거합니다.

구문

HRESULT WsRemoveMappedHeader(
  [in]           WS_MESSAGE          *message,
  [in]           const WS_XML_STRING *headerName,
  [in, optional] WS_ERROR            *error
);

매개 변수

[in] message

헤더를 설정할 메시지입니다.

메시지는 모든 상태일 수 있지만 WS_MESSAGE_STATE_EMPTY.

[in] headerName

제거할 매핑된 헤더의 이름입니다.

[in, optional] error

함수가 실패할 경우 추가 오류 정보를 저장할 위치를 지정합니다.

반환 값

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

반환 코드 설명
E_INVALIDARG
 하나 이상의 매개 변수가 잘못되었습니다.
기타 오류
이 함수는 위에 나열되지 않은 다른 오류를 반환할 수 있습니다.

설명

메시지에 메시지 봉투의 일부가 아닌 추가 전송 관련 정보가 포함될 수 있습니다. 이 전송 관련 정보는 Message 개체의 헤더로 프로그래밍 방식으로 노출될 수 있습니다. 이 함수는 메시지 개체에서 매핑된 헤더를 제거하는 데 사용됩니다. 사용자 지정 채널 구현에서 메시지를 보내기 전에 매핑된 헤더를 제거하는 데 사용할 수 있습니다.

요구 사항

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