Função phoneSetData (tapi.h)
A função phoneSetData baixa as informações no buffer especificado para o dispositivo de telefone aberto no identificador de dados selecionado.
Sintaxe
LONG phoneSetData(
HPHONE hPhone,
DWORD dwDataID,
LPVOID const lpData,
DWORD dwSize
);
Parâmetros
hPhone
Identificador para o dispositivo de telefone aberto. O aplicativo deve ser o proprietário do telefone.
dwDataID
Onde no dispositivo de telefone o buffer deve ser baixado.
lpData
Ponteiro para o local de memória do qual os dados devem ser baixados.
dwSize
Tamanho do buffer, em bytes.
Valor retornado
Retornará 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 valores retornados possíveis são:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_INVALDATAID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED.
Comentários
A função phoneSetData baixa um máximo de dwSize bytes de lpData para o dispositivo de telefone. O formato dos dados, seu significado para o dispositivo de telefone e o significado do identificador de dados são específicos do provedor de serviços. Os dados no buffer ou a seleção de um identificador de dados podem atuar como comandos para o dispositivo de telefone.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | tapi.h |
| Biblioteca | Tapi32.lib |
| DLL | Tapi32.dll |