IUserNotification2::P laySound 메서드(shobjidl.h)
알림과 함께 소리를 재생합니다.
구문
HRESULT PlaySound(
[in] LPCWSTR pszSoundName
);
매개 변수
[in] pszSoundName
형식: LPCWSTR
재생할 사운드 파일의 별칭을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.
반환 값
형식: HRESULT
메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
pszSoundName이 가리키는 문자열에는 레지스트리 또는 Win.ini 파일에 있는 시스템 이벤트에 대한 별칭이 포함되어 있습니다. instance "SystemExit"의 경우
지정된 소리가 비동기적으로 재생되고 메서드는 소리를 시작한 직후에 반환됩니다. 비동기 파형 사운드를 중지하려면 pszSoundName이 NULL로 설정된 IUserNotification2::P laySound를 호출합니다.
지정된 사운드 이벤트는 이미 재생 중인 다른 사운드 이벤트로 생성됩니다. 해당 소리를 재생하는 데 필요한 리소스가 사용 중이기 때문에 소리를 재생할 수 없는 경우 메서드는 요청된 소리를 재생하지 않고 즉시 S_FALSE 반환합니다.
지정된 소리를 찾을 수 없는 경우 IUserNotification2::P laySound 는 시스템 기본 소리를 사용합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | shobjidl.h |