ICommandWithParameters Interface

IID_ICommandWithParameters

{0C733A64-2A1C-11CE-ADE5-00AA0044773D}

This optional interface encapsulates parameters. Parameters are scalar values, or a vector of scalar values, typically expressed in predicates but possibly supported by many providers in any scalar expression.

Documentation: ICommandWithParameters

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

ICommandWithParameters Methods

Description

GetParameterInfo

Gets a list of the command's parameters, their names, and their types.

MapParameterNames

Returns an array of parameter ordinals when given named parameters.

SetParameterInfo

Specifies the native data type of each parameter.

GetParameterInfo

FUNCTION ICommandWithParameters_GetParameterInfo ( _
  BYVAL pthis AS DWORD PTR _

, BYREF pcParams AS DWORD _

, BYREF prgParamInfo AS DBPARAMINFO _

, BYREF ppNamesBuffer AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[3] USING ICommandWithParameters_GetParameterInfo (pthis, pcParams, prgParamInfo, ppNamesBuffer) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

MapParameterNames

FUNCTION ICommandWithParameters_MapParameterNames ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL cParamNames AS DWORD _

, BYREF rgParamNames AS DWORD _

, BYREF rgParamOrdinals AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[4] USING ICommandWithParameters_MapParameterNames (pthis, cParamNames, rgParamNames, rgParamOrdinals) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

SetParameterInfo

FUNCTION ICommandWithParameters_SetParameterInfo ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL cParams AS DWORD _

, BYREF rgParamOrdinals AS DWORD _

, BYREF rgParamBindInfo AS DBPARAMBINDINFO _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[5] USING ICommandWithParameters_SetParameterInfo (pthis, cParams, rgParamOrdinals, rgParamBindInfo) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION