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
S_OK
Der Lesevorgang sollte fortgesetzt werden.
WMDM_E_USER_CANCELLED
Der Lesevorgang sollte ohne Abschluss abgebrochen werden.
E_FAIL
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

Weitere Informationen

Manuelles Behandeln von Dateiübertragungen

IWMDMOperation-Schnittstelle

IWMDMOperation::SetObjectName