Freigeben über


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
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
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.)
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)
Die Gerätebeschreibung konnte nicht gefunden werden.
S_OK
Die Methode wurde erfolgreich ausgeführt.
E_POINTER
Mindestens eines der erforderlichen Argumente war ein NULL-Zeiger .

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile portabledeviceapi.h
Bibliothek PortableDeviceGUIDs.lib

Weitere Informationen

IPortableDeviceManager-Schnittstelle

IPortableDeviceManager::GetDevices