WsCheckMustUnderstandHeaders 함수(webservices.h)

지정된 헤더가 수신자가 이해했는지 확인합니다.

참고 수신된 메시지에 대해 모든 헤더를 읽은 후에 이 함수를 호출해야 합니다.

구문

HRESULT WsCheckMustUnderstandHeaders(
  [in]           WS_MESSAGE *message,
  [in, optional] WS_ERROR   *error
);

[in] message

이해할 헤더를 포함하는 WS_MESSAGE 구조체에 대한 포인터입니다.

[in, optional] error

함수가 실패할 경우 추가 오류 정보가 저장되는 WS_ERROR 구조체에 대한 포인터입니다.

함수가 성공하면 NO_ERROR 반환합니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

반환 코드	설명
WS_E_INVALID_OPERATION	메시지가 올바른 상태가 아닙니다. 자세한 내용은 주의 섹션을 참조하세요.
WS_E_INVALID_FORMAT	유효성 검사에 실패했거나 메시지가 올바르게 구성되지 않았습니다.
E_INVALIDARG	하나 이상의 인수가 잘못되었습니다.
E_OUTOFMEMORY	메모리가 부족하여 작업을 완료할 수 없습니다.
기타 오류	이 함수는 위에 나열되지 않은 다른 오류를 반환할 수 있습니다.

헤더 집합을 확장할 수 있으므로 메시지를 충분히 처리할 수 있는지 여부를 확인해야 합니다. 따라서 발신자는 이 함수를 사용하여 이해해야 하는 헤더, 선택적 또는 정보로 처리할 수 있는 헤더를 나타낼 수 있습니다.

WS_HEADER_TYPE 정의된 헤더와 같은 표준 주소 지정 헤더는 WsGetHeader를 호출하여 읽지 않더라도 자동으로 이해되는 것으로 간주됩니다.

WsGetCustomHeader에서 읽은 사용자 지정 애플리케이션 정의 헤더도 이해되는 것으로 간주됩니다. WsGetCustomHeader를 호출하면 특정 헤더가 자동으로 이해됨으로 표시됩니다.

애플리케이션에서 처리한 다른 헤더의 경우 애플리케이션은 WsMarkHeaderAsUnderstood를 호출하여 헤더를 명시적으로 이해됨으로 표시해야 합니다. 그렇지 않으면 헤더를 이해할 수 없는 것으로 간주됩니다.

수신된 메시지에 대해 모든 헤더를 읽은 후에 이 함수를 호출해야 합니다. 이 함수를 호출해야 하는 예외는 최종 노드가 검사 수행하므로 ID(메시지 ID)를 변경하지 않고 메시지를 다른 노드로 전달하는 중개자의 경우입니다.

지정된 헤더가 이해되지 않으면 함수가 실패합니다. 오류 개체가 함수에 제공되면 오류를 보내는 데 사용할 수 있는 정보로 채워집니다( WsCreateFaultFromError 참조).

메시지는 WS_MESSAGE_STATE_READING 상태여야 합니다.