OpenTP1 Version 7 Programming Reference C Language
dc_mcf_adltap - Delete an application timer start request
Format
ANSI C, C++
#include <dcmcf.h> int dc_mcf_adltap (DCLONG action, dcmcf_adltapopt *apopt, char *resv01, DCLONG *resv02, char *resv03, char *resv04) |
K&R C
#include <dcmcf.h> int dc_mcf_adltap (action, apopt, resv01, resv02, resv03, resv04) DCLONG action; dcmcf_adltapopt *apopt; char *resv01; DCLONG *resv02; char *resv03; char *resv04; |
Description
The function dc_mcf_adltap() deletes a specified application timer start request and cancels startup of the application. Note that this function cannot delete application timer start requests of the ans and cont types.
Arguments whose values are set in the UAP
action
Specify DCMCFAP to indicate that an application name is to be specified.
apopt
Set in a dcmcf_adltapopt structure the connection information that is to be the subject of this function's processing.
The following shows the format of the structure:
typedef struct { DCLONG mcfid; ...Application start process identifier char resv01[4]; ...Reserved char idnam[9]; ...Application name char resv02[7]; ...Reserved char resv03[112]; ...Reserved char resv04[376]; ...Reserved } dcmcf_adltapopt;
resv01, resv02, resv03, resv04
Specify NULL.
Return values
Return value | Return value (numeric) | Explanation |
---|---|---|
DCMCFRTN_00000 | 0 | Normal termination. |
DCMCFRTN_71001 | -12001 | The dc_mcf_adltap() function cannot be accepted because the MCF is under start processing. |
DCMCFRTN_71002 | -12002 | The dc_mcf_adltap() function cannot be accepted because the MCF is under termination processing. |
DCMCFRTN_71004 | -12004 | A memory shortage occurred during dc_mcf_adltap() function processing. |
DCMCFRTN_71005 | -12005 | A communication error occurred. For the cause, see the message log file. |
DCMCFRTN_71006 | -12006 | An internal error occurred. For the cause, see the message log file. |
DCMCFRTN_71007 | -12007 | The specified application name has not been registered. |
No timer start request has been issued for the specified application name. | ||
The specified application name belongs to an application whose type is inquiry-response or continuous-inquiry-response. | ||
DCMCFRTN_71009 | -12009 | The dc_mcf_adltap() function is not supported by the applicable application start process. |
DCMCFRTN_71010 | -12010 | Although the request to delete the specified application timer start request was issued, the request was not accepted. For the cause, see the message log file. |
DCMCFRTN_72050 | -13050 | DCMCFAP is not specified in action. |
An unsupported flag is set in action. | ||
DCMCFRTN_72051 | -13051 | NULL is set in apopt. |
DCMCFRTN_72052 | -13052 | NULL is not set in resv01. |
DCMCFRTN_72053 | -13053 | NULL is not set in resv02. |
DCMCFRTN_72054 | -13054 | NULL is not set in resv03. |
DCMCFRTN_72055 | -13055 | NULL is not set in resv04. |
DCMCFRTN_72061 | -13061 | A value of 0 or smaller or of 240 or greater is specified for mcfid in dcmcf_adltapopt. |
DCMCFRTN_72062 | -13062 | resv01 in dcmcf_adltapopt is not filled with null characters. |
DCMCFRTN_72063 | -13063 | idnam in dcmcf_adltapopt begins with the null character. |
DCMCFRTN_72064 | -13064 | resv02 in dcmcf_adltapopt is not filled with null characters. |
DCMCFRTN_72065 | -13065 | resv03 in dcmcf_adltapopt is not filled with null characters. |
DCMCFRTN_72067 | -13067 | resv04 in dcmcf_adltapopt is not filled with null characters. |
DCMCFRTN_72073 | -13073 | The character string set in idnam in dcmcf_adltapopt is 9 bytes or more in length. |
DCMCFRTN_72074 | -13074 | The character string set in idnam in dcmcf_adltapopt contains an invalid character. |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.