服務主機

服務主機是用來在進程內裝載服務的運行時間環境。

服務可以在服務主機內設定一或多個端點。

建立服務主機

建立服務主機之前，服務必須定義其端點。 服務主機中的端點是在 WS_SERVICE_ENDPOINT 結構中指定，並由下列資訊定義：

• 位址，這是將裝載服務的實體 URI。
• WS_CHANNEL_TYPE 結構，指定端點的基礎通道類型。
• 指定通道系結的 WS_CHANNEL_BINDING 結構。
• 包含端點安全性描述的 WS_SECURITY_DESCRIPTION 結構。
• WS_SERVICE_CONTRACT 結構，表示端點的 服務合約。
• WS_SERVICE_SECURITY_CALLBACK 結構，指定端點的授權回呼函式。
• 包含服務端點屬性陣列的 WS_SERVICE_ENDPOINT_PROPERTY 結構。

WS_SERVICE_ENDPOINT serviceEndpoint = {0};
const WS_SERVICE_ENDPOINT* serviceEndpoints[1];
serviceEndpoints[0] = &serviceEndpoint;
WS_STRING url = WS_STRING_VALUE(L"net.tcp://+/Example");

// Method based service contract for the service
static WS_SERVICE_CONTRACT calculatorContract = 
{
    &calculatorContractDescription, // comes from a generated header.
    NULL,
    &calculatorFunctions, // specified by the application
};

serviceEndpoint.address.url = &url;
serviceEndpoint.binding.channelBinding =  WS_TCP_CHANNEL_BINDING; 
serviceEndpoint.contract = &calculatorContract;  
serviceEndpoint.channelType = WS_CHANNEL_TYPE_DUPLEX_SESSION; 
serviceEndpoint.authorizationCallback = AuthorizationCallback; // Authorization callback.

WS_CHANNEL_BINDING 列舉中 WS_UDP_CHANNEL_BINDING 所代表的SOAP over UDP僅支援單向合約。

定義端點之後，可以將它傳遞至 WsCreateServiceHost 函式，此函式會接受 WS_SERVICE_ENDPOINT 結構的指標數位。

HRESULT hr = WsCreateServiceHost (serviceEndpoints, 1, NULL, 0, &host, error);

應用程式可以選擇性地提供 服務屬性陣列，WsCreateServiceHost 在服務主機上設定自定義設定。

應用程式會開啟服務主機以開始接受用戶端要求。

WsOpenServiceHost(serviceHost, NULL, NULL);

開啟服務主機之後，如果不需要再執行任何作業，應用程式就可以關閉它。 請注意，這不會釋放其資源，而且可以使用後續呼叫來重新開啟 WsResetServiceHost。

WsCloseServiceHost(serviceHost, NULL, NULL);

關閉服務主機之後，應用程式可能會重設服務主機以供重複使用。

WsResetServiceHost(serviceHost, NULL);

當應用程式使用服務主機完成時，可以呼叫 WsFreeServiceHost 函式來釋放與服務主機相關聯的資源。 請注意，必須先呼叫 WsCloseServiceHost，才能呼叫此函式。

WsFreeServiceHost(serviceHost, NULL);

如需將自定義狀態附加至服務主機的資訊，請參閱 用戶主機狀態

如需指定端點之服務主機中授權的資訊，請參閱 服務授權。

如需實作服務作業和服務合約的 iinformation，請參閱 服務作業 和 服務合約主題。

安全

應用程式可以使用下列屬性來控制服務主機代表應用程式配置的資源數量：

• WS_SERVICE_ENDPOINT_PROPERTY_MAX_ACCEPTING_CHANNELS、
• WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY、
• WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNELS、
• WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_MAX_SIZE、
• WS_SERVICE_ENDPOINT_PROPERTY_MAX_CALL_POOL_SIZE、
• WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE。

針對每個屬性選擇安全預設值，如果應用程式想要修改這些屬性，就必須小心。 除了上述屬性之外，通道、接聽程式 和 訊息 特定屬性也可以由應用程式修改。 在修改這些設定之前，請參閱這些元件的安全性考慮。

此外，在使用WWSAPI服務主機 API 時，應仔細評估下列應用程式設計考慮：

• 使用 MEX 時，應用程式應該小心不要揭露任何敏感數據。 作為緩和措施，如果透過 MEX 公開的數據本質很敏感，應用程式可以選擇使用至少需要驗證的安全系結來設定 MEX 端點，並使用 WS_SERVICE_SECURITY_CALLBACK作為端點的一部分實作授權。
• 根據預設，透過錯誤的豐富錯誤資訊會透過 WS_SERVICE_PROPERTY_FAULT_DISCLOSURE 屬性在服務主機上停用。 應用程式可自行決定將豐富的錯誤資訊傳送為錯誤的一部分。 不過，這可能會導致資訊洩漏，因此建議只針對偵錯案例變更此設定。
• 除了針對基本配置檔 2.0 和 XML 串行化執行的驗證之外，服務主機不會對作為服務作業參數一部分接收的數據內容執行任何驗證。 應用程式有責任自行執行所有參數驗證。
• 授權不會實作為服務主機的一部分。 不過，應用程式可以使用 WS_SECURITY_DESCRIPTION 和 WS_SERVICE_SECURITY_CALLBACK來實作自己的授權配置。
• 應用程式有責任在其端點上使用安全系結。 服務主機不會提供端點上所設定專案以外的任何安全性。

下列 API 元素會與服務主機搭配使用。