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 アプリ]
Header	webservices.h