IPortableDeviceService::GetPnPServiceID-Methode (portabledeviceapi.h)

  • Artikel

Die GetPnPServiceID-Methode ruft einen PnP-Bezeichner (Plug & Play) für den Dienst ab.

Syntax

HRESULT GetPnPServiceID(
  [out] LPWSTR *ppszPnPServiceID
);

Parameter

[out] ppszPnPServiceID

Der abgerufene PnP-Bezeichner, bei dem es sich um denselben Bezeichner handelt, der an die Open-Methode übergeben wurde.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.
E_POINTER
 Ein NULL-Parameter wurde angegeben.
E_WPD_SERVICE_NOT_OPEN
 Die Open-Methode wurde für den Dienst noch nicht aufgerufen.

Hinweise

Die Open-Methode muss für den Dienst aufgerufen werden, bevor ein PnP-Bezeichner abgerufen werden kann.

Wenn eine Anwendung den PnP-Bezeichner nicht mehr benötigt, sollte sie die CoTaskMemFree-Funktion aufrufen, um den Bezeichnerspeicher freizugeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile portabledeviceapi.h

Weitere Informationen

IPortableDeviceService-Schnittstelle