IPortableDevice::GetPnPDeviceID-Methode (portabledeviceapi.h)
Die GetPnPDeviceID-Methode ruft den PnP-Gerätebezeichner (Plug and Play) ab, den die Anwendung zum Öffnen des Geräts verwendet hat.
Syntax
HRESULT GetPnPDeviceID(
[out] LPWSTR *ppszPnPDeviceID
);
Parameter
[out] ppszPnPDeviceID
Zeiger auf eine NULL-endende Zeichenfolge, die die Plug-and-Play-ID-Zeichenfolge für das Gerät enthält.
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Die IPortableDevice::Open-Methode wurde für dieses Gerät noch nicht aufgerufen. |
Hinweise
Nachdem die Anwendung die von dieser Methode zurückgegebene Zeichenfolge verwendet hat, muss sie die CoTaskMemFree-Funktion aufrufen, um die Zeichenfolge freizugeben.
Das Argument ppszPnPDeviceID darf nicht auf NULL festgelegt werden.
Requirements (Anforderungen)
| Zielplattform | Windows |
| Kopfzeile | portabledeviceapi.h |
| Bibliothek | PortableDeviceGUIDs.lib |