IWMDMOperation::GetObjectName-Methode (mswmdm.h)
Windows Media Geräte-Manager ruft GetObjectName auf, bevor ein Objekt auf das Gerät geschrieben wird, um zu wissen, wie es auf dem Gerät benannt werden soll.
Syntax
HRESULT GetObjectName(
[out] LPWSTR pwszName,
[in] UINT nMaxChars
);
Parameter
[out] pwszName
Zeiger auf eine Breitzeichen-NULL-endende Zeichenfolge, die den Objektnamen angibt. Der Name sollte bei Bedarf eine Dateierweiterung enthalten. Windows Media Geräte-Manager ordnet diesen Puffer zu und gibt diesen frei. nMaxChars gibt die maximale Anzahl von Zeichen an, einschließlich des endenden NULL-Zeichens.
[in] nMaxChars
Ganze Zahl, die die Anzahl der Zeichen in pwszName angibt, einschließlich des abschließenden NULL-Zeichens.
Rückgabewert
Die Anwendung sollte einen der folgenden HRESULT-Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Der Lesevorgang sollte fortgesetzt werden. |
|
Der Lesevorgang sollte ohne Abschluss abgebrochen werden. |
|
Ein nicht angegebener Fehler ist aufgetreten, und der Lesevorgang sollte abgebrochen werden, ohne abgeschlossen zu sein. |
Hinweise
Diese Methode wird nur aufgerufen, wenn die Anwendung den Namen nicht als Parameter in der Insert-Methode angegeben hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | mswmdm.h |
| Bibliothek | Mssachlp.lib |