DTWAIN_ArrayGetCapValuesEx2

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

DTWAIN_ARRAY DTWAIN_ArrayGetCapValuesEx2 (

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

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

TwainDataType

Indicates the TWAIN data type 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_ArrayGetCapValuesEx2 function works exactly the same as DTWAIN_GetCapValuesEx2, 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