IPortableDeviceManager::GetDeviceManufacturer-Methode (portabledeviceapi.h)
Ruft den Namen des Geräteherstellers ab.
Syntax
HRESULT GetDeviceManufacturer(
[in] LPCWSTR pszPnPDeviceID,
[in, out] WCHAR *pDeviceManufacturer,
[in, out] DWORD *pcchDeviceManufacturer
);
Parameter
[in] pszPnPDeviceID
Zeiger auf eine null-beendete Zeichenfolge, die die Plug & Play-ID des Geräts enthält. Sie können eine Liste mit Plug & Play Namen aller Geräte abrufen, die mit dem Computer verbunden sind, indem Sie GetDevices aufrufen.
[in, out] pDeviceManufacturer
Ein vom Aufrufer zugewiesener Puffer, der den Namen des Geräteherstellers enthält. Um die erforderliche Größe für diesen Parameter zu ermitteln, rufen Sie zuerst diese Methode auf, wobei dieser Parameter auf NULL festgelegt ist und pcchDeviceManufacturer auf 0 festgelegt ist. die Methode erfolgreich ist, und legen Sie pcchDeviceManufacturer auf die erforderliche Puffergröße fest, um den gerätefreundlichen Namen einschließlich des Abschlusszeichens zu enthalten.
[in, out] pcchDeviceManufacturer
Bei der Eingabe die maximale Anzahl von Zeichen, die pDeviceManufacturer enthalten kann, ohne das Beendigungszeichen. Bei der Ausgabe die Anzahl der von pDeviceManufacturer zurückgegebenen Zeichen, ohne das Beendigungszeichen.
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 |
---|---|
|
Der bereitgestellte Puffer ist nicht groß genug, um die Gerätebeschreibung aufzunehmen. (Die erforderliche Größe finden Sie im wert, der in pcchDeviceDescription zurückgegeben wird.) |
|
Die Gerätebeschreibung konnte nicht gefunden werden. |
|
Die Methode wurde erfolgreich ausgeführt. |
|
Mindestens eines der erforderlichen Argumente war ein NULL-Zeiger . |
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Windows |
Kopfzeile | portabledeviceapi.h |
Bibliothek | PortableDeviceGUIDs.lib |