WsCreateServiceEndpointFromTemplate 関数 (webservices.h)

ポリシー テンプレートからサービス エンドポイント (WS_SERVICE_ENDPOINT) を作成するためのヘルパー ルーチン。

構文

HRESULT WsCreateServiceEndpointFromTemplate(
  [in]           WS_CHANNEL_TYPE                    channelType,
  [in]           const WS_SERVICE_ENDPOINT_PROPERTY *properties,
  [in]           ULONG                              propertyCount,
  [in, optional] const WS_STRING                    *addressUrl,
  [in]           const WS_SERVICE_CONTRACT          *contract,
  [in]           WS_SERVICE_SECURITY_CALLBACK       authorizationCallback,
  [in]           WS_HEAP                            *heap,
  [in]           WS_BINDING_TEMPLATE_TYPE           templateType,
  [in]           void                               *templateValue,
  [in]           ULONG                              templateSize,
  [in]           const void                         *templateDescription,
  [in]           ULONG                              templateDescriptionSize,
  [out]          WS_SERVICE_ENDPOINT                **serviceEndpoint,
  [in, optional] WS_ERROR                           *error
);

パラメーター

[in] channelType

エンドポイントによってホストされるチャネルの種類を表す WS_CHANNEL_TYPE 列挙値。

[in] properties

サービス エンドポイントのプロパティを含む WS_SERVICE_ENDPOINT_PROPERTY 構造体の配列。 (アプリケーションでは、テンプレート構造のチャネル プロパティを入力する必要があります)。

[in] propertyCount

プロパティ配列内の プロパティ の数。

[in, optional] addressUrl

エンドポイントがリッスンする URL アドレス。

[in] contract

エンドポイントのコントラクトを表す WS_SERVICE_CONTRACT 構造体。

[in] authorizationCallback

サービス エンドポイント のWS_SERVICE_SECURITY_CALLBACK 承認コールバック。

[in] heap

正常な戻り時にサービス エンドポイントのメモリが割り当てられる ヒープ 。

[in] templateType

サービス エンドポイントの作成に使用されるテンプレートの種類を表す WS_BINDING_TEMPLATE_TYPE 列挙値。

[in] templateValue

アプリケーションによって作成および入力されるオプションのテンプレート構造。 テンプレートは、入力テンプレートの種類 ( templateType パラメーターで渡される) と一致している必要があります。 templateValue パラメーターが NULL の場合、対応するテンプレート構造が 0 に初期化されているのと同じです。

[in] templateSize

入力 templateValue 構造体のサイズ (バイト単位)。

[in] templateDescription

テンプレート構造の説明 ( templateValue パラメーターで渡されます)。 templateType と一致する必要があります。

[in] templateDescriptionSize

テンプレートの説明のサイズ。

[out] serviceEndpoint

成功した場合、新しいサービス エンドポイントを表す WS_SERVICE_ENDPOINT 構造体のアドレスを受け取るポインター。

[in, optional] error

関数が失敗した場合に追加のエラー情報を受け取る WS_ERROR 構造体へのポインター。

戻り値

関数が成功すると、NO_ERRORが返されます。それ以外の場合は、HRESULT エラー コードが返されます。

注釈

WsCreateServiceEndpointFromTemplate は、指定された入力ポリシー テンプレートと追加のユーザー入力から WS_SERVICE_ENDPOINT 構造を作成します。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	webservices.h
Library	WebServices.lib
[DLL]	WebServices.dll