Supported LOB Locator Conversions

The table lists the LOB locator conversions.

CS_TEXT_ LOCATOR

CS_IMAGE_ LOCATOR

CS_UNITEXT_ LOCATOR

CS_CHAR_TYPE

X

X

X

CS_TEXT_TYPE

X

CS_IMAGE_TYPE

X

CS_UNITEXT_TYPE

X

CS_TEXT_LOCATOR

X

CS_IMAGE_LOCATOR

X

CS_UNITEXT_LOCATOR

X

LEGEND: X = supported conversion.

When working with locator datatypes:
  • ct_bind() ignores the maxlength value of CS_DATAFMT because Client-Library considers the length of locator datatypes as fixed. Memory required for any optional prefetched data that is sent with the locator is allocated internally for its entire length. The maxlength value does not influence the length of the prefetched data.

  • You can bind an incoming LOB locator to CS_CHAR_TYPE. You cannot, however, directly bind a locator to CS_TEXT_TYPE, CS_IMAGE_TYPE, or CS_UNITEXT_TYPE.