Método IUserNotification::P laySound (shobjidl_core.h)
Reproduz um som em conjunto com a notificação.
Sintaxe
HRESULT PlaySound(
[in] LPCWSTR pszSoundName
);
Parâmetros
[in] pszSoundName
Tipo: LPCWSTR
Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o alias do arquivo de som a ser reproduzido.
Retornar valor
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
A cadeia de caracteres apontada por pszSoundNamepqc contém um alias para um evento do sistema encontrado no registro ou no arquivo Win.ini; por exemplo, "SystemExit".
O som especificado é reproduzido de forma assíncrona e o método retorna imediatamente após o início do som. Para interromper um som de forma de onda assíncrona, chame IUserNotification::P laySound com pszSoundNamepqc definido como NULL.
O evento de som especificado produzirá para outro evento de som que já está sendo reproduzido. Se um som não puder ser reproduzido porque o recurso necessário para reproduzir esse som estiver ocupado, o método retornará imediatamente S_FALSE sem reproduzir o som solicitado.
Se o som especificado não puder ser encontrado, IUserNotification::P laySound usará o som padrão do sistema.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | shobjidl_core.h (inclua Shobjidl.h) |