IUPnPDevice::get_ParentDevice-Methode (upnp.h)
Die ParentDevice-Eigenschaft gibt das übergeordnete Element des Geräts an.
Syntax
HRESULT get_ParentDevice(
[out] IUPnPDevice **ppudDeviceParent
);
Parameter
[out] ppudDeviceParent
Empfängt einen Verweis auf ein IUPnPDevice-Objekt , das das übergeordnete Gerät beschreibt. Dieser Verweis muss freigegeben werden, wenn er nicht mehr erforderlich ist. Wenn das Gerät kein übergeordnetes Gerät hat, ist es ein oberstes Gerät, und der Parameter empfängt NULL.
Rückgabewert
Für C++: Wenn die "get"-Methode dieser Eigenschaft erfolgreich ist, wird der Rückgabewert S_OK. Wenn es sich bei dem Gerät um ein oberstes Gerät handelt, wird der Rückgabewert S_FALSE. Andernfalls gibt die Methode einen der in WinError.h definierten COM-Fehlercodes zurück.
Hinweise
Verwenden Sie IUPnPDevice::IsRootDevice, um festzustellen, ob das Gerät über kein übergeordnetes Element verfügt.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | upnp.h |
| DLL | Upnp.dll |