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)