dc_mcf_open - Open the MCF environment

Format

ANSI C, C++

#include <dcmcf.h>
int  dc_mcf_open(DCLONG flags)

K&R C

#include <dcmcf.h>
int  dc_mcf_open (flags)
DCLONG      flags;

Description

The function dc_mcf_open() constructs the environment in which MCF facilities are used. Call the function dc_mcf_open() for UAPs which use MCF facilities.

After the dc_rpc_open() is called, the function dc_mcf_open() must be called in the main function. Issue the function dc_mcf_open() only once in the process before the function dc_mcf_mainloop() (function dc_rpc_mainloop() for an SPP). The following shows when to call the function dc_mcf_open():

dc_rpc_open()
dc_mcf_open()
dc_mcf_mainloop() (dc_rpc_mainloop() for an SPP)
  :
  :
dc_mcf_close()
dc_rpc_close()

Argument whose value is set in the UAP

flags

Specify DCNOFLAGS.

Return values

Return valueReturn value (numeric)Explanation
DC_OK0Normal termination.
DCMCFER_INVALID_ARGS-11900The value specified for flags is invalid.
DCMCFER_PROTO-11901The function dc_rpc_open() was not called.
The function dc_mcf_open() was called.
DCMCFER_FATAL-11902Initialization processing was unsuccessful.
DCMCFER_NOMEM-11903The memory became insufficient.