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 はシステムの既定のサウンドを使用します。

要件