Function _conSetFieldCC() Foundation

Assign the value of a container to a field variable of a specified workarea.

Syntax
XPPAPIRET _conSetFieldCC(CHAR *warea,
                         CHAR *field,
                         ContainerHandle chValue);
Parameters
CHAR* warea
The character pointer warea contains the alias name of a workarea.
CHAR* field
The character pointer field contains the name of the Xbase++ field variable.
ContainerHandle chValue
The handle of the container whose value is to be assigned to the specified field variable.
Return

This function returns NULL in case no error occured, otherwise it returns an error code (XPP_ERR_...).

Description

This function us used to assign a new value to specific field variable of a certain workarea.

Examples
#include <windows.h> 

#include "xppdef.h" 
#include "xpppar.h" 
#include "xppcon.h" 

XPPRET XPPENTRY MyCAPIFunction(XppParamList paramList) 
{ 
ContainerHandle chName  = _conGetFieldCC( "PHONELIST", "NAME",  NULLCONTAINER ); 
ContainerHandle chPhone = _conGetFieldCC( "PHONELIST", "PHONE", NULLCONTAINER ); 

/* Now swap name and phone number... */ 

if(_conSetFieldCC( "PHONELIST", "NAME", chPhone )) 
{ 
   /* Error handler... */ 
} 

if(_conSetFieldCC( "PHONELIST", "PHONE", chName )) 
{ 
   /* Error handler... */ 
} 
} 

/* Xbase++ code */ 
PROCEDURE Main 
LOCAL aStruct := { { "NAME",  "C", 30, 0 }, ; 
                   { "PHONE", "C", 30, 0 }  } 
CLS 

DbCreate( "PHONELIST", aStruct ) 

USE PHONELIST NEW EXCLUSIVE 

APPEND BLANK 
PHONELIST->NAME  := "XENIA B." 
PHONELIST->PHONE := "+49 6196 9572-0" 

? "NAME :", PHONELIST->NAME 
? "PHONE:", PHONELIST->PHONE 

MyCAPIFunction() 

? "NAME :", PHONELIST->NAME 
? "PHONE:", PHONELIST->PHONE 

CLOSE DATABASES 
RETURN 

Feedback

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.