IMDSPStorage::GetName-Methode (mswmdm.h)

Artikel
02/29/2024

Die GetName-Methode ruft den Anzeigenamen des Speicherobjekts ab.

Syntax

HRESULT GetName(
  [out] LPWSTR pwszName,
  [in]  UINT   nMaxChars
);

Parameter

[out] pwszName

Zeiger auf eine (Unicode)-Zeichenfolge mit breitem Nullzeichen, die den Objektnamen enthält.

[in] nMaxChars

Ganze Zahl, die die maximale Anzahl von Zeichen enthält, die in die Namenszeichenfolge kopiert werden können.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

Com-Standardfehlercodes
In HRESULT-Werte konvertierte Windows-Fehlercodes
Windows Media Geräte-Manager Fehlercodes

Eine ausführliche Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Der Anzeigename des Objekts ist der Dateiname ohne Pfadinformationen. In hierarchischen Medien wird der Anzeigename mit den Vorgängerinstanzen von IMDSPStorage-Schnittstellen verkettet, um einen vollständigen pfadqualifizierten Namen zu erstellen.

Der LPWSTR-Zeichenfolgentyp ist eine 16-Bit-Unicode-Zeichenfolge und akzeptiert keine Byte-Zeichen.

Diese Methode muss implementiert werden. Es darf keine WMDM_E_NOTSUPPORTED oder E_NOTIMPL zurückgegeben werden. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.