IUserNotification::P laySound メソッド (shobjidl_core.h)

通知と組み合わせてサウンドを再生します。

構文

HRESULT PlaySound(
  [in] LPCWSTR pszSoundName
);

[in] pszSoundName

種類: LPCWSTR

再生するサウンドファイルのエイリアスを指定する null で終わる Unicode 文字列へのポインター。

型: HRESULT

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

pszSoundNamepqc が指す文字列には、レジストリまたは Win.ini ファイルで見つかったシステムイベントのエイリアスが含まれています。たとえば、"SystemExit" です。

指定したサウンドは非同期的に再生され、メソッドはサウンドを開始した直後にを返します。非同期波形サウンドを停止するには、pszSoundNamepqc を NULL に設定して IUserNotification::P laySound を呼び出します。

指定したサウンドイベントは、既に再生されている別のサウンドイベントに生成されます。そのサウンドを再生するために必要なリソースがビジー状態であるためにサウンドを再生できない場合、メソッドは要求されたサウンドを再生せずにすぐにS_FALSEを返します。

指定したサウンドが見つからない場合、 IUserNotification::P laySound はシステムの既定のサウンドを使用します。

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)