ARSetMenuToXML

Description

This function saves information about a menu in an XML document.

Synopsis

#include "arextern.h"

int ARSetMenuToXML(
  ARControlStruct *control,
  ARXMLOutputDoc *xmlOutputDoc,
  ARBoolean xmlDocHdrFtrFlag,
  ARNameType menuName,
  unsigned int *refreshCode,
  ARCharMenuStruct *menuDefn,
  ARAccessNameType owner,
  ARAccessNameType lastModifiedBy,
  ARTimestamp *modifiedDate,
  char *helpText,
  char *changeHistory,
  ARPropList *objPropList,
  unsigned int *arDocVersion,
  ARStatusList *status)

Input arguments

control

The control record for the operation. It contains information about the user requesting the operation, where that operation must be performed, and the session used to perform it. The user, sessionId, and server fields are required.

xmlOutputDoc

The XML document output source.

xmlDocHdrFtrFlag

The header and footer flag for the XML document output source. If there is only one object in the XML document, set this value to 0.

menuName

The menu name. Each menu name must be unique.

refreshCode

A value that indicates when the menu is refreshed.

Specify NULL for this parameter if you do not want to retrieve this value.

See ARCreateCharMenu for a description of the possible values.

menuDefn

The definition of the character menu.

Specify NULL for this parameter if you do not want to retrieve this value.

owner

The menu owner.

lastModifiedBy

The user who last modified the menu.

modifiedDate

The date that the menu was last modified.

helpText

The help text associated with the menu.

Specify NULL for this parameter if you do not want to retrieve the help text (which is useful if you are calling this function to verify whether an instance of this object exists).

changeHistory

The change history of the menu.

objPropList

The object properties of the menu.

arDocVersion

The version of the XML document.

Return values

status

A list of zero or more notes, warnings, or errors generated from a call made to this function.

For a description of all possible values, see Error-checking.