IUserNotification::P laySound 메서드(shobjidl_core.h)

알림과 함께 소리를 재생합니다.

구문

HRESULT PlaySound(
  [in] LPCWSTR pszSoundName
);

[in] pszSoundName

형식: LPCWSTR

재생할 소리 파일의 별칭을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

pszSoundNamepqc에서 가리키는 문자열에는 레지스트리 또는 Win.ini 파일에 있는 시스템 이벤트에 대한 별칭이 포함되어 있습니다. instance "SystemExit"의 경우

지정된 소리는 비동기적으로 재생되고 메서드는 소리를 시작한 직후에 반환됩니다. 비동기 파형 소리를 중지하려면 pszSoundNamepqc가 NULL로 설정된 IUserNotification::P laySound를 호출합니다.

지정된 사운드 이벤트는 이미 재생 중인 다른 사운드 이벤트로 생성됩니다. 해당 소리를 재생하는 데 필요한 리소스가 사용 중이므로 소리를 재생할 수 없는 경우 메서드는 요청된 소리를 재생하지 않고 즉시 S_FALSE 반환합니다.

지정된 사운드를 찾을 수 없는 경우 IUserNotification::P laySound 는 시스템 기본 사운드를 사용합니다.