IUPnPRegistrar::UnregisterDevice メソッド (upnphost.h)
UnregisterDevice メソッドは、デバイス ホストからデバイスの登録を解除します。 デバイスが一時的または永続的に登録解除されている。
構文
HRESULT UnregisterDevice(
[in] BSTR bstrDeviceIdentifier,
[in] BOOL fPermanent
);
パラメーター
[in] bstrDeviceIdentifier
登録解除するデバイスのデバイス識別子を指定します。 デバイス識別子は、RegisterDevice または RegisterRunningDevice の以前の呼び出しから返されました。
[in] fPermanent
デバイスを完全または一時的に登録解除するかどうかを指定します。 デバイス ホストからデバイスを完全に登録解除するには 、TRUE を 指定します。 FALSE を指定して一時的に登録を解除します。
戻り値
メソッドが成功した場合、戻り値はS_OK。 それ以外の場合、メソッドは WinError.h で定義されている COM エラー コードのいずれかを返します。
注釈
このメソッドは、デバイス ホストからデバイスを削除します。 fPermanent が TRUE の場合、デバイスは完全に登録解除されます。 それ以外の場合、デバイスはデバイス ホストによって生成された UDN へのデバイス識別子 ( RegisterDevice または RegisterRunningDevice から返されます) のデバイス ホストのマッピングに保持されます。 デバイスが一時的に登録解除された場合は、デバイスが再登録されるときに、デバイスに関連付けられている以前の UDN を使用します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | upnphost.h |
| [DLL] | Upnphost.dll |