VpeGetFieldName

<< Click to Display Table of Contents >>

Navigation:  Field >

VpeGetFieldName

Previous pageReturn to chapter overviewNext page

Returns the name of the Field as defined in dycodoc.

void VpeGetFieldName(

VpeHandle hField,

LPSTR value,

UINT *size

)

VpeHandle hField

Field Handle

LPSTR value

Pointer to a buffer that receives the string with the Field name.
This parameter can be NULL, if the data is not required, in such case no data is copied.

UINT *size

Pointer to a variable that specifies the size, in bytes, of the buffer pointed to by the value parameter. When the function returns, this variable contains the number of bytes copied to value - including the size of the terminating null character.

If value is NULL, and size is non-NULL, the function returns True and stores the size of the data, in bytes, in the variable pointed to by size. This lets an application determine the best way to allocate a buffer for the value's data.

Returns:

Value

Description

True

value retrieved successfully

False

value could not be retrieved (for example out of memory)

Example:

UINT uSize;

char szFieldName[256];

uSize = sizeof(szFieldName);

VpeGetFieldName(hField, szFieldName, &uSize);

 

See Also:

"dycodoc Template Processing" in the Programmer's Manual