WS_CREATE_LISTENER_CALLBACK回呼函式 (webservices.h)

  • 發行項

處理WS_CUSTOM_CHANNEL_BINDING的WsCreateListener呼叫。

語法

WS_CREATE_LISTENER_CALLBACK WsCreateListenerCallback;

HRESULT WsCreateListenerCallback(
  [in]           WS_CHANNEL_TYPE channelType,
                 const void *listenerParameters,
  [in]           ULONG listenerParametersSize,
                 void **listenerInstance,
  [in, optional] WS_ERROR *error
)
{...}

參數

[in] channelType

接聽程式所接聽的通道類型。

listenerParameters

使用WsCreateListener建立自訂接聽程式時，由 WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS屬性所指定的值指標。

如果未指定 WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS 屬性，則此值會是 Null。

[in] listenerParametersSize

listenerParameters 所指向之值的位元組大小。

如果未指定 WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS 屬性，大小會是 0。

listenerInstance

表示接聽程式實例之已配置結構的指標。 此指標會傳遞至這個特定接聽程式實例的所有其他接聽程式回呼。

如果此回呼成功，則會使用 WS_FREE_LISTENER_CALLBACK 來釋放接聽程式實例。

[in, optional] error

指定函式失敗時應該儲存其他錯誤資訊的位置。

傳回值

傳回碼 描述
WS_E_QUOTA_EXCEEDED
 超過配額。
E_OUTOFMEMORY
 記憶體不足。
E_INVALIDARG
 一或多個引數無效。
其他錯誤
此函式可能會傳回上述未列出的其他錯誤。

規格需求

   
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 webservices.h