WsRemoveHeader 함수(webservices.h)

  • 아티클

메시지에서 표준 WS_HEADER_TYPE 개체를 제거합니다.

함수는 메시지에 한 번 표시되고 최종 수신자를 대상으로 하는 헤더 유형을 처리하도록 설계되었습니다. 궁극의 수신기 이외의 역할을 대상으로 하는 헤더는 무시됩니다.

애플리케이션 정의 헤더 형식의 경우 WsRemoveCustomHeader 함수를 사용합니다.

구문

HRESULT WsRemoveHeader(
  [in]           WS_MESSAGE     *message,
  [in]           WS_HEADER_TYPE headerType,
  [in, optional] WS_ERROR       *error
);

매개 변수

[in] message

제거할 헤더가 있는 Message 개체에 대한 포인터입니다. 메시지는 WS_MESSAGE_STATE_EMPTY 제외한 모든 상태에 있을 수 있습니다.

[in] headerType

제거할 헤더의 형식을 나타냅니다.

[in, optional] error

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

반환 값

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

반환 코드 설명
WS_E_INVALID_FORMAT
 메시지에 있는 헤더 형식의 여러 인스턴스가 있습니다.
E_INVALIDARG
 하나 이상의 매개 변수가 잘못되었습니다.
기타 오류
이 함수는 위에 나열되지 않은 다른 오류를 반환할 수 있습니다.

설명

지정된 형식의 헤더가 메시지에 있으면 제거됩니다. 헤더가 없으면 아무 작업도 수행되지 않고 함수가 성공적으로 완료됩니다.

요구 사항

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