WS_ENDPOINT_ADDRESS 구조체(webservices.h)

엔드포인트의 네트워크 주소를 나타냅니다.

구문

typedef struct _WS_ENDPOINT_ADDRESS {
  WS_STRING            url;
  WS_XML_BUFFER        *headers;
  WS_XML_BUFFER        *extensions;
  WS_ENDPOINT_IDENTITY *identity;
} WS_ENDPOINT_ADDRESS;

멤버

url

주소의 URL 부분입니다.

URL은 항상 이스케이프된 형식입니다.

이 문자열이 길이가 0이면 URL은 익명 주소로 간주됩니다. 익명 주소 문자열은 엔드포인트 주소가 WS_ENDPOINT_ADDRESS_TYPE 사용하여 직렬화되거나 역직렬화될 때 길이가 0인 문자열과 자동으로 매핑됩니다.

이 필드의 값은 WS-Addressing 사양의 Address 요소에 해당합니다.

headers

엔드포인트 주소에 대한 참조 매개 변수를 나타내는 헤더 요소 집합에 대한 WS_XML_BUFFER 핸들입니다.

헤더는 엔드포인트와 제대로 상호 작용하는 데 필요합니다. 주소(URL)를 추가로 한정하는 데 사용됩니다.

헤더는 엔드포인트 주소의 사용자에게 불투명 값으로 처리되어야 합니다.

전송되는 메시지에 헤더를 추가하는 방법에 대한 자세한 내용은 WsAddressMessage 를 참조하세요.

헤더가 없는 경우 이 필드는 NULL 일 수 있습니다.

이 필드의 이 값은 WS-Addressing 사양의 ReferenceParameters 요소 내용에 해당합니다.

extensions

확장 요소 집합에 대한 WS_XML_BUFFER 핸들입니다. 확장 요소는 엔드포인트 주소 내에 추가 정보를 포함하는 데 사용됩니다. 확장 요소가 없는 경우 이 필드는 NULL 일 수 있습니다.

이 필드의 이 값은 WS-Addressing 정의된 다른 요소 및 모든 확장 요소에 해당합니다. 요소는 사양에 따라 올바른 순서로 표시되어야 하며 확장 요소가 뒤따라야 합니다. 이러한 값은 이 구조체의 다른 필드에 의해 직접 표현되므로 이 필드에는 Address 또는 ReferenceParameters 또는 Identity에 대한 요소가 포함되어서는 안 됩니다.

ReferenceProperties 요소가 있는 경우( WS_ADDRESSING_VERSION_0_9 정의한 대로) WS_XML_BUFFER 내의 첫 번째 요소여야 합니다.

identity

이 엔드포인트 주소로 표시되는 엔드포인트의 보안 ID입니다.

이 필드는 기본 WS-Addressing 사양의 확장인 Identity 요소에 해당합니다.

설명

URL 필드만 필요합니다(다른 필드는 NULL일 수 있음).

요구 사항

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