デバイスの登録解除

デバイスの登録を解除するには、 IUPnPRegistrar::UnregisterDevice メソッドを使用します。 デバイスは、 fPermanent の値に応じて、一時的または永続的に登録解除 (デバイス ホストから削除) できます。 デバイスが再登録され、デバイスが同じ UDN を使用する必要がある場合、開発者はデバイスを一時的に削除する必要があります。 それ以外の場合、デバイスは完全に削除されます。

登録解除に使用される GUID は UDN ではありません。 IUPnPRegistrar::RegisterDevice または IUPnPRegistrar::RegisterRunningDevice によって返される ID を使用する必要があります。

Note

IUPnPRegistrar オブジェクトを解放できます。 ID のみをキャッシュする必要があります。

 

fPermanent が FALSE の場合、デバイスは一時的に削除されます。 デバイスを再登録するには、 IUPnPReregistrar インターフェイスを使用します。 IUPnPReregistrar::ReregisterDevice メソッドと IUPnPReregistrar::ReregisterRunningDevice メソッドは、入れ子になったデバイスの場合、登録されていないデバイスのデバイス ホストによって以前に生成された同じ UDN または UDN を使用します。

fPermanent が TRUE の場合、デバイスはデバイス ホストから完全に削除されます。 このデバイスを同じコンピューターに再度登録すると、以前に作成した UDN とは異なる UDN が作成されます。

Note

デバイスが同じコンピューターに複数回登録されると、デバイス ホストはデバイスのインスタンスごとに異なる UDN を生成します。