Compartilhar via


Função phoneSetLamp (tapi.h)

A função phoneSetLamp faz com que a lâmpada especificada seja acesa no dispositivo de telefone aberto especificado no modo de lâmpada especificado.

Sintaxe

LONG phoneSetLamp(
  HPHONE hPhone,
  DWORD  dwButtonLampID,
  DWORD  dwLampMode
);

Parâmetros

hPhone

Manipule para o dispositivo de telefone aberto. O aplicativo deve ser o proprietário do telefone.

dwButtonLampID

Botão cuja lâmpada deve ser acesa.

dwLampMode

Como a lâmpada deve ser acesa. Esse parâmetro usa uma e apenas uma das constantes PHONELAMPMODE_.

Retornar valor

Retorna um identificador de solicitação positivo se a função for concluída de forma assíncrona ou um número de erro negativo se ocorrer um erro. O parâmetro dwParam2 da mensagem de PHONE_REPLY correspondente será zero se a função for bem-sucedida ou se for um número de erro negativo se ocorrer um erro. Os possíveis valores retornados são:

PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_INVALBUTTONLAMPID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALLAMPMODE, PHONEERR_UNINITIALIZED.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi.h
Biblioteca Tapi32.lib
DLL Tapi32.dll

Confira também

PHONE_REPLY

Funções de serviço de telefonia suplementar

Visão geral da referência do TAPI 2.2