Метод IUserNotification2::P laySound (shobjidl.h)
Воспроизводит звук вместе с уведомлением.
Синтаксис
HRESULT PlaySound(
[in] LPCWSTR pszSoundName
);
Параметры
[in] pszSoundName
Тип: LPCWSTR
Указатель на строку Юникода, завершающуюся значением NULL, которая указывает псевдоним воспроизводимого звукового файла.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Строка, на которую указывает pszSoundName , содержит псевдоним системного события, найденного в реестре или Win.ini файле; например SystemExit.
Указанный звук воспроизводится асинхронно, и метод возвращает сразу после начала звука. Чтобы остановить асинхронный звуковой сигнал, вызовите IUserNotification2::P laySound с параметром pszSoundName , имеющим значение NULL.
Указанное звуковое событие передастся другому звуковому событию, которое уже воспроизводится. Если звук не может быть воспроизведен, так как ресурс, необходимый для воспроизведения этого звука, занят, метод немедленно возвращает S_FALSE без воспроизведения запрошенного звука.
Если указанный звук не найден, IUserNotification2::P laySound использует системный звук по умолчанию.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | shobjidl.h |