função TSPI_phoneSetButtonInfo (tspi.h)
A função TSPI_phoneSetButtonInfo define informações sobre o botão especificado no telefone especificado.
Sintaxe
LONG TSPIAPI TSPI_phoneSetButtonInfo(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
DWORD dwButtonLampID,
LPPHONEBUTTONINFO const lpButtonInfo
);
Parâmetros
dwRequestID
O identificador da solicitação assíncrona. O provedor de serviços retornará esse valor se a função for concluída de forma assíncrona.
hdPhone
O identificador para o telefone para o qual as informações do botão devem ser definidas.
dwButtonLampID
Um botão no dispositivo de telefone.
lpButtonInfo
Um ponteiro para uma estrutura de tamanho variável do tipo PHONEBUTTONINFO. Essa estrutura de dados descreve o modo e a função e fornece texto descritivo adicional a ser definido para o botão.
Retornar valor
Retorna o valor dwRequestID (positivo) se a função for concluída de forma assíncrona ou um número de erro se ocorrer um erro. O parâmetro real lResult do ASYNC_COMPLETION correspondente será zero se a função for bem-sucedida ou se for um número de erro se ocorrer um erro. Os possíveis valores retornados são os seguintes:
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALBUTTONLAMPID, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Comentários
Essa função define o significado e o texto descritivo associado dos botões de um telefone.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |