WS_FAULT 구조체(webservices.h)

  • 아티클

오류는 처리 실패를 전달하는 메시지 본문에 전달되는 값입니다. 오류는 WS_FAULT 구조를 사용하여 모델링됩니다.

구문

typedef struct _WS_FAULT {
  WS_FAULT_CODE   *code;
  WS_FAULT_REASON *reasons;
  ULONG           reasonCount;
  WS_STRING       actor;
  WS_STRING       node;
  WS_XML_BUFFER   *detail;
} WS_FAULT;

멤버

code

오류 유형을 식별하는 오류 코드 목록의 머리입니다.

오류 코드는 가장 일반적인 코드에서 가장 구체적인 코드로 정렬됩니다. 하나 이상의 오류 코드가 있어야 합니다. 첫 번째 오류 코드는 SOAP로 정의된 오류 코드에 해당해야 합니다. WS_ENVELOPE_VERSION_SOAP_1_1 경우 가장 구체적인 오류 코드만 직렬화됩니다(목록의 첫 번째 코드).

첫 번째 오류 코드의 네임스페이스 URI가 빈 문자열이면 다음과 같이 오류가 직렬화될 때 첫 번째 오류 코드가 다음과 같이 변환됩니다.

이러한 변환을 사용하면 어떤 SOAP 버전이 사용되는지 걱정할 필요 없이 SOAP 오류 코드를 지정할 수 있습니다.

reasons

오류를 설명하는 텍스트입니다. 이는 다양한 언어를 허용하는 배열입니다.

reasonCount

이유 배열의 이유 수입니다. 텍스트가 여러 언어로 표현된 경우 둘 이상입니다. 하나 이상의 오류 이유가 있어야 합니다.

WS_ENVELOPE_VERSION_SOAP_1_1 경우 첫 번째 이유만 직렬화됩니다.

actor

오류를 발생시킨 프로세서의 이름입니다. 문자열 길이가 0이면 엔드포인트로 간주됩니다.

node

오류를 발생시킨 프로세서의 위치입니다. 문자열 길이가 0이면 엔드포인트로 간주됩니다.

WS_ENVELOPE_VERSION_SOAP_1_1 경우 이 값은 직렬화되지 않습니다.

detail

오류 세부 정보를 사용하면 XML 콘텐츠를 오류와 함께 포함할 수 있습니다. 세부 정보가 없으면 이 필드는 NULL일 수 있습니다.

WS_ENVELOPE_VERSION_SOAP_1_1 경우 오류는 메시지의 헤더 처리와 관련이 없는 경우에만 사용해야 합니다. 헤더와 관련된 오류는 사용자 지정 헤더를 사용하여 오류에 대한 정보를 릴레이해야 합니다.

오류에 대한 세부 정보가 있는 경우 WS_XML_BUFFER SOAP 오류의 세부 요소에 해당하는 요소를 포함해야 합니다. 오류별 XML 콘텐츠는 detail 요소 내에 포함됩니다. 요소의 로컬 이름 및 네임스페이스는 무시됩니다. detail 요소가 작성되면 WS_ENVELOPE_VERSION 따라 적절한 요소 이름으로 바뀝니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱 | UWP 앱]
머리글 webservices.h