DTWAIN_ArrayGetCapValuesEx

The DTWAIN_ArrayGetCapValuesEx function gets the capability value(s) for a Source while specifying the TWAIN container type to use.

DTWAIN_ARRAY DTWAIN_ArrayGetCapValuesEx (

DTWAIN_SOURCE	Source,
LONG	Capability,
LONG	GetType,
LONG	Container );

Parameters

Source

An open TWAIN Source.

Capability

The capability that is to be retrieved.

GetType

Indicates which type of retrieval to do.

Container

Indicates the TWAIN container to use

Return Values

The return value is a DTWAIN_ARRAY containing the values retrieved. NULL is returned if the capability does not exist for the Source, or if there is some other error retrieving the capability.

Comments

The DTWAIN_ArrayGetCapValuesEx function works exactly the same as DTWAIN_GetCapValuesEx, except that the DTWAIN_ARRAY is returned instead of the programmer having to provide the address of an existing DTWAIN_ARRAY.

If the returned DTWAIN_ARRAY is NULL, you should call DTWAIN_GetLastError to determine the cause of the failure.

TWAIN State Transitions

The Source must be in State 4 or higher (depending on the capability).

Prerequisite Function Call(s)

DTWAIN_SysInitialize

DTWAIN Source Selection Function