ISSCommandWithParameters (Native Client OLE DB provider)

Applies to: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Important

The SQL Server Native Client (often abbreviated SNAC) has been removed from SQL Server 2022 (16.x) and SQL Server Management Studio 19 (SSMS). Both the SQL Server Native Client OLE DB provider (SQLNCLI or SQLNCLI11) and the legacy Microsoft OLE DB Provider for SQL Server (SQLOLEDB) are not recommended for new development. Switch to the new Microsoft OLE DB Driver (MSOLEDBSQL) for SQL Server going forward.

ISSCommandWithParameters exposes support for SQL Server XML and user-defined types (UDT). This is an optional interface that inherits from the core OLE DB interface ICommandWithParameters. In addition to the three methods inherited from ICommandWithParameters; GetParameterInfo, MapParameterNames, and SetParameterInfo; ISSCommandWithParameters provides two new methods that are used to handle server specific data types.

Note

The ISSCommandWithParameters interface can be used when Service Components are used, but the Service Components themselves will not use this interface.

Method Description
ISSCommandWithParameters::GetParameterProperties (OLE DB) Returns one SSPARAMPROPS property set structure in the array for each UDT or XML parameter passed to the command, but none is returned for other types of parameters.
ISSCommandWithParameters::SetParameterProperties (OLE DB) Sets the parameter properties on a per parameter basis by ordinal, or sets bulk parameter properties by specifying an array of SSPARAMPROPS structures.

See Also

Interfaces (OLE DB)
Using XML Data Types
Using User-Defined Types