IUPnPDeviceFinderCallback::D eviceAdded メソッド (upnp.h)
DeviceAdded メソッドは、デバイスがネットワークに追加されたことをアプリケーションに通知するために、UPnP フレームワークによって呼び出されます。
構文
HRESULT DeviceAdded(
[in] LONG lFindData,
[in] IUPnPDevice *pDevice
);
パラメーター
[in] lFindData
UPnP フレームワークが結果を返す検索を指定します。 lFindData の値は、IUPnPDeviceFinder::CreateAsyncFind によって呼び出し元に返される値です。
[in] pDevice
新しいデバイスを含む IUPnPDevice オブジェクトへの参照。
戻り値
UPnP フレームワークでは、アプリケーションが特定の値を返す必要はありません。返される値は、UPnP フレームワークでは無視されます。
注釈
UPnP フレームワークでは、デバイスがネットワークに追加されたときにアプリケーションに通知するために、DeviceAdded の代わりに IUPnPDeviceFinderAddCallbackWithInterface::D eviceAddedWithInterface メソッドを呼び出す場合があります。 UPnP フレームワークはクエリを実行して 、IUPnPDeviceFinderAddCallbackWithInterface インターフェイスが存在するかどうかを確認します。 その場合、UPnP フレームワークは DeviceAddedWithInterface を呼び出します。 それ以外の場合、UPnP フレームワークは DeviceAdded を呼び出します。
UPnP フレームワークは、同じデバイスに対して 2 つ以上のコールバックを返す場合があります。 これは、デバイスの IP アドレスが最初にデバイスを削除せずに変更された後、ネットワークに再追加した場合に発生する可能性があります。 これが発生した場合、アプリケーションは古いデバイスを破棄し、最後に返されたデバイスを使用する必要があります。 アプリケーションは、UDN を比較して重複するデバイスをチェックします。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | upnp.h |
| [DLL] | Upnp.dll |