다음을 통해 공유

WsRemoveCustomHeader 함수(webservices.h)

  • 아티클

메시지에서 사용자 지정 헤더를 제거합니다.

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

구문

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

매개 변수

[in] message

제거할 헤더가 있는 Message 개체에 대한 포인터입니다.

메시지는 WS_MESSAGE_STATE_EMPTY 제외한 모든 상태에 있을 수 있습니다.

[in] headerName

제거할 헤더 요소의 "로컬 이름"을 참조하는 WS_XML_STRING 개체에 대한 포인터입니다.

[in] headerNs

제거할 헤더 요소의 네임스페이스를 참조하는 WS_XML_STRING 개체에 대한 포인터입니다.

[in, optional] error

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

반환 값

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

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

설명

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

요구 사항

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