iWSDDeviceProxy::Init 方法 (wsdclient.h)
初始化裝置 Proxy,選擇性地與先前初始化的贊助裝置 Proxy 共用會話。
語法
HRESULT Init(
[in] LPCWSTR pszDeviceId,
[in] IWSDAddress *pDeviceAddress,
[in] LPCWSTR pszLocalId,
[in, optional] IWSDXMLContext *pContext,
[in, optional] IWSDDeviceProxy *pSponsor
);
參數
[in] pszDeviceId
裝置的邏輯位址 (標識碼) 。
[in] pDeviceAddress
包含裝置組態數據的 IWSDAddress 物件參考。
[in] pszLocalId
用戶端的邏輯位址。 邏輯位址的格式為 urn:uuid:{guid}。 當伺服器需要起始與客戶端的連線時使用。
[in, optional] pContext
定義自訂訊息類型或命名空間的 IWSDXMLContext 物件的參考。
如果為 NULL,則會使用代表內建訊息類型和命名空間的預設內容。
[in, optional] pSponsor
IWSDDeviceProxy 對象的參考,這是用來共用會話和較低層的選擇性裝置。
傳回值
可能的傳回值包括但不限於下列各項:
傳回碼 | 描述 |
---|---|
|
方法已順利完成。 |
|
pszDeviceId 為 NULL、 pszLocalId 為 NULL,或標識符字串的字元長度超過 WSD_MAX_TEXT_LENGTH (8192) 。 |
|
記憶體不足,無法完成作業。 |
備註
此方法是由 WSDCreateDeviceProxy 呼叫,而且通常不需要由用戶端程式代碼直接呼叫。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | wsdclient.h (包含 Wsdapi.h) |
Dll | Wsdapi.dll |