IUserNotification::P laySound 方法 (shobjidl_core.h)
与通知一起播放声音。
语法
HRESULT PlaySound(
[in] LPCWSTR pszSoundName
);
参数
[in] pszSoundName
类型: LPCWSTR
指向以 null 结尾的 Unicode 字符串的指针,该字符串指定要播放的声音文件的别名。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
pszSoundNamepqc 指向的字符串包含注册表或 Win.ini 文件中找到的系统事件的别名;例如,“SystemExit”。
指定的声音以异步方式播放,该方法在开始声音后立即返回。 若要停止异步波形声音,请调用 IUserNotification::P laySoundSound, 将 pszSoundNamepqc 设置为 NULL。
指定的声音事件将产生另一个已在播放的声音事件。 如果由于播放该声音所需的资源正忙而无法播放声音,该方法会立即返回S_FALSE,而不播放请求的声音。
如果找不到指定的声音, 则 IUserNotification::P laySound 使用系统默认声音。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | shobjidl_core.h (包括 Shobjidl.h) |