IMDSPDevice::GetName-Methode (mswmdm.h)
Die GetName-Methode ruft den Namen des Geräts ab.
Syntax
HRESULT GetName(
[out] LPWSTR pwszName,
[in] UINT nMaxChars
);
Parameter
[out] pwszName
Zeiger auf ein Array von 16-Bit-Unicode-Zeichen, das die Gerätenamenzeichenfolge empfängt.
[in] nMaxChars
Maximale Anzahl von Zeichen, die in die Zeichenfolge kopiert werden sollen.
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:
- Standard-COM-Fehlercodes
- In HRESULT-Werte konvertierte Windows-Fehlercodes
- Windows Media Geräte-Manager Fehlercodes
Hinweise
Der LPWSTR-Zeichenfolgentyp ist eine 16-Bit-Unicode-Zeichenfolge und akzeptiert keine Bytezeichen. Verwenden Sie die MultiByteToWideChar-Funktion, wie in der Microsoft Windows-Dokumentation beschrieben, um eine Zeichenfolge mit Bytegröße (LPCSTR) in eine LPWSTR-Zeichenfolge zu konvertieren.
Gerätenamen dürfen keine nachfolgenden Leerzeichen enthalten.
Diese Methode muss implementiert werden. Es darf keine WMDM_E_NOTSUPPORTED oder E_NOTIMPL zurückgeben. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | mswmdm.h |
| Bibliothek | Mssachlp.lib |