Compartilhar via


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)