Поделиться через

Метод IUserNotification::P laySound (shobjidl_core.h)

  • Статья

Воспроизводит звук в сочетании с уведомлением.

Синтаксис

HRESULT PlaySound(
  [in] LPCWSTR pszSoundName
);

Параметры

[in] pszSoundName

Тип: LPCWSTR

Указатель на строку Юникода, завершающуюся null, которая указывает псевдоним воспроизводимого звукового файла.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Строка, на которую указывает pszSoundNamepqc , содержит псевдоним системного события, найденного в реестре или файле Win.ini; например SystemExit.

Указанный звук воспроизводится асинхронно, и метод возвращается сразу после начала звука. Чтобы остановить асинхронный звуковой сигнал, вызовите IUserNotification::P laySound с параметром pszSoundNamepqc со значением NULL.

Указанное звуковое событие передастся другому звуковому событию, которое уже воспроизводится. Если звук не может быть воспроизведен, так как ресурс, необходимый для воспроизведения этого звука, занят, метод немедленно возвращает S_FALSE без воспроизведения запрошенного звука.

Если указанный звук не найден, IUserNotification::P laySound использует системный звук по умолчанию.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header shobjidl_core.h (включая Shobjidl.h)