OpenTP1 Version 7 Programming Reference C Language

[Contents][Index][Back][Next]

dc_mcf_tempput - Update temporary-stored data

Format

ANSI C, C++

#include <dcmcf.h>
int  dc_mcf_tempput(DCLONG action,char *putdata,DCLONG pdataleng,
                     char *resv01)

K&R C

#include <dcmcf.h>
int  dc_mcf_tempput (action, putdata, pdataleng, resv01)
DCLONG    action;
char      *putdata;
DCLONG    pdataleng;
char      *resv01;

Description

The function dc_mcf_tempput() updates data stored in the temporary-stored area which is used for continuous-inquiry-response processing.

Call the function dc_mcf_tempget() before the function dc_mcf_tempput().

The figure below shows the format of the send segment area. With buffer format 1, L is 8 bytes; with buffer format 2, L is 6 bytes.

[Figure]

Arguments whose values are set in the UAP

action

Specify the type of buffer format to be used.

{DCMCFBUF1|DCMCFBUF2}

DCMCFBUF1
Specify that buffer format 1 is used.

DCMCFBUF2
Specify that buffer format 2 is used.

putdata

Specify the area storing the temporary-stored data to be updated.

ptempleng

Specify the length of the temporary-stored data to be updated.

resv01

Specify a null character.

Return values

Return value Return value (numeric) Explanation
DCMCFRTN_00000 0 Normal termination.
DCMCFRTN_71103 -12103 The area for updating the temporary-stored data could not be acquired.
DCMCFRTN_72000 -13000 The function dc_mcf_tempput() cannot be called from an SPP.
DCMCFRTN_72016 -13016 The value specified for action is invalid.
The value of the area pointed to by resv01 is not a null character.
DCMCFRTN_72035 -13035 The value specified for the data update length exceeds the value specified for the temporary data storage area length in the MCF application definition.
The value specified for the data update length is less than 1 byte.
DCMCFRTN_72101 -13101 The function dc_mcf_tempput() was called from an MHP for which type=cont (continuous-inquiry-response type) was not specified in the MCF application definition.
DCMCFRTN_72105 -13105 The function dc_mcf_tempput() was called before the function dc_mcf_tempget().
DCMCFRTN_72106 -13106 The function dc_mcf_tempput() was called before the function dc_mcf_receive() for receiving the first segment.
DCMCFRTN_72107 -13107 The function dc_mcf_tempput() was called after the function dc_mcf_contend().
Other than the above An unprecedented error (e.g., program damage) occurred.