Метод IWMDMOperation::GetObjectName (mswmdm.h)

Windows Media диспетчер устройств вызывает GetObjectName перед записью объекта на устройство, чтобы узнать, как он должен называться на устройстве.

Синтаксис

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

Параметры

[out] pwszName

Указатель на строку с расширенными символами, завершающуюся нулевым значением, которая указывает имя объекта. При необходимости имя должно содержать расширение файла. Windows Media диспетчер устройств выделяет и освобождает этот буфер. nMaxChars указывает максимальное количество символов, включая завершающий символ NULL.

[in] nMaxChars

Целое число, указывающее количество символов в pwszName, включая завершающий символ NULL.

Возвращаемое значение

Приложение должно вернуть одно из следующих значений HRESULT .

Код возврата	Описание
S_OK	Операция чтения должна продолжиться.
WMDM_E_USER_CANCELLED	Операция чтения должна быть отменена без завершения.
E_FAIL	Произошла неустановленная ошибка, и операция чтения должна быть отменена без завершения.

Комментарии

Этот метод вызывается только в том случае, если приложение не указало имя в качестве параметра в методе Insert .

Требования

Требование	Значение
Целевая платформа	Windows
Header	mswmdm.h
Библиотека	Mssachlp.lib

См. также раздел

Обработка передачи файлов вручную

Интерфейс IWMDMOperation

IWMDMOperation::SetObjectName