IPortableDeviceService::Advise 方法 (portabledeviceapi.h)
建議方法會註冊可接收服務事件的應用程式定義回呼物件。
語法
HRESULT Advise(
[in] const DWORD dwFlags,
[in] IPortableDeviceEventCallback *pCallback,
[in] IPortableDeviceValues *pParameters,
[out] LPWSTR *ppszCookie
);
參數
[in] dwFlags
未使用。
[in] pCallback
IPortableDeviceEventCallback 介面,指定要註冊的回呼物件。
[in] pParameters
指定事件註冊參數的 IPortableDeviceValues 介面,如果回呼物件是要接收所有服務事件,則為 NULL 。
[out] ppszCookie
回呼物件的唯一內容識別碼。 這個值會比對 Unadvise 方法用來取消註冊回呼物件。
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
傳回碼 | 描述 |
---|---|
|
此方法已成功。 |
|
已針對 pCallback 參數或 ppszCookie 參數指定 NULL 值。 |
備註
在清除期間,應用程式應該藉由呼叫 Unadvise 方法取消註冊回呼對象,然後藉由呼叫 CoTaskMemFree 函式釋放 ppszCookie 參數所參考的記憶體。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 7 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | portabledeviceapi.h |