Método IUserNotification2::P laySound (shobjidl.h)

  • Artigo

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 pszSoundName 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 IUserNotification2::P laySound com pszSoundName 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 tocado 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, IUserNotification2::P laySound usará o som padrão do sistema.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl.h

Confira também

IUserNotification2

PlaySound