Windows Dev Center

IUserNotification::PlaySound method

Plays a sound in conjunction with the notification.

Syntax


HRESULT PlaySound(
  [in] LPCWSTR pszSoundNamepqc
);

Parameters

pszSoundNamepqc [in]

Type: LPCWSTR

A pointer to a null-terminated Unicode string that specifies the alias of the sound file to play.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The string pointed to by pszSoundNamepqc contains an alias for a system event found in the registry or the Win.ini file; for instance, "SystemExit".

The specified sound is played asynchronously and the method returns immediately after beginning the sound. To stop an asynchronous waveform sound, call IUserNotification::PlaySound with pszSoundNamepqc set to NULL.

The specified sound event will yield to another sound event that is already playing. If a sound cannot be played because the resource needed to play that sound is busy, the method immediately returns S_FALSE without playing the requested sound.

If the specified sound cannot be found, IUserNotification::PlaySound uses the system default sound.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

 

 

Community Additions

ADD
Show:
© 2015 Microsoft