Diese Funktionsgruppe ruft den Wert des angegebenen Syntaxelements ab.
Geben Sie die entsprechende Funktion aus dieser Gruppe an, die dem Datentyp entspricht, der abgerufen werden soll:
CciSize cpiElementBitArrayValue(
int* returnCode,
CciElement* targetElement,
const struct CciBitArray* value);
CciBool cpiElementBooleanValue(
int* returnCode,
CciElement* targetElement);
CciSize cpiElementByteArrayValue(
int* returnCode,
CciElement* targetElement,
const struct CciByteArray* value);
CciSize cpiElementCharacterValue(
int* returnCode,
CciElement* targetElement,
const CciChar* value,
CciSize length);
struct CciDate cpiElementDateValue(
int* returnCode,
CciElement* targetElement);
CciSize cpiElementDecimalValue(
int* returnCode,
CciElement* targetElement,
const CciChar* value,
CciSize length);
struct CciTimestamp cpiElementGmtTimestampValue(
int* returnCode,
CciElement* targetElement);
struct CciTime cpiElementGmtTimeValue(
int* returnCode,
CciElement* targetElement);
CciInt cpiElementIntegerValue(
int* returnCode,
CciElement* targetElement);
CciReal cpiElementRealValue(
int* returnCode,
CciElement* targetElement);
struct CciTimestamp cpiElementTimestampValue(
int* returnCode,
CciElement* targetElement);
struct CciTime cpiElementTimeValue(
int* returnCode,
CciElement* targetElement);
Der Wert des Elements wird zurückgegeben.
In einigen Fällen, wenn der Puffer nicht groß genug ist, um die Daten zu empfangen, werden die Daten nicht in den Puffer geschrieben. Die Größe des erforderlichen Puffers wird als Rückgabewert übergeben, und der Rückkehrcode wird auf CCI_BUFFER_TOO_SMALL gesetzt. Dieses Verfahren wird beispielsweise von cpiElementCharacterValue oder cpiElementDecimalValue verwendet.
Wenn ein Fehler auftritt, gibt returnCode den Grund für den Fehler an.