ユーザー定義型の使用

PROCEDURE_PARAMETERS スキーマ行セットには、次の列が追加されました。

SQL Server Native Client OLE DB プロバイダは、登録済みの UDT に関する情報が格納される、プロバイダ固有の新しいスキーマ行セットを公開します。ASSEMBLY_SERVER を DBTYPE_WSTR 型として指定することはできますが、行セットには格納されません。指定しない場合、行セットでは既定で現在のサーバーが使用されます。次の表に、SQL_ASSEMBLIES スキーマ行セットの定義を示します。

SQL Server Native Client OLE DB プロバイダでは、特定のサーバーにおけるアセンブリの依存関係に関する情報が格納される、プロバイダ固有の新しいスキーマ行セットを公開します。ASSEMBLY_SERVER は呼び出し元により DBTYPE_WSTR 型として指定することができますが、行セットには格納されません。指定しない場合、行セットでは既定で現在のサーバーが使用されます。次の表に、SQL_ASSEMBLY_DEPENDENCIES スキーマ行セットの定義を示します。

SQL Server Native Client OLE DB プロバイダは、特定サーバーの登録済み UDT が追加されたタイミングに関する情報が格納される、新しいスキーマ行セット SQL_USER_TYPES を公開します。UDT_SERVER は、呼び出し元により DBTYPE_WSTR 型として指定される必要がありますが、行セットには格納されません。次の表に、SQL_USER_TYPES スキーマ行セットの定義を示します。

COLUMNS スキーマ行セットには、次の列が追加されました。

OLE DB で UDT をサポートするため、SQL Server Native Client では、次の値を含む新しい DBPROPSET_SQLSERVERPARAMETER プロパティ セットが実装されました。

SSPROP_PARAM_UDT_NAME は必須です。SSPROP_PARAM_UDT_CATALOGNAME と SSPROP_PARAM_UDT_SCHEMANAME は省略可能です。いずれかのプロパティが適切に指定されていない場合、DB_E_ERRORSINCOMMAND が返されます。SSPROP_PARAM_UDT_CATALOGNAME プロパティと SSPROP_PARAM_UDT_SCHEMANAME プロパティがどちらも指定されていない場合、UDT は、テーブルと同じデータベースおよびスキーマ内に定義する必要があります。UDT の定義が、テーブルと同じデータベース内にあって、同じスキーマ内にない場合、SSPROP_PARAM_UDT_SCHEMANAME プロパティを指定する必要があります。UDT の定義がテーブルと異なるデータベースにある場合、SSPROP_PARAM_UDT_CATALOGNAME プロパティと SSPROP_PARAM_UDT_SCHEMANAME プロパティの両方を指定する必要があります。

ITableDefinition インターフェイスでのテーブルの作成をサポートするため、SQL Server Native Client では、DBPROPSET_SQLSERVERCOLUMN プロパティ セットに次の 3 つの新しい列が追加されました。

注
UDT は PROVIDER_TYPES スキーマ行セットには表示されません。すべての列は読み取り/書き込みアクセスです。

ADO では、"説明" 列の対応するエントリを使用してこれらのプロパティを参照します。

SSPROP_COL_UDTNAME は必須です。SSPROP_COL_UDT_CATALOGNAME と SSPROP_COL_UDT_SCHEMANAME は省略可能です。いずれかのプロパティが適切に指定されていない場合、DB_E_ERRORSINCOMMAND が返されます。

SSPROP_COL_UDT_CATALOGNAME プロパティと SSPROP_COL_UDT_SCHEMANAME プロパティがどちらも指定されていない場合、UDT は、テーブルと同じデータベースおよびスキーマ内に定義する必要があります。

UDT の定義が、テーブルと同じデータベース内にあって、同じスキーマ内にない場合、SSPROP_COL_UDT_SCHEMANAME プロパティを指定する必要があります。

UDT の定義がテーブルと異なるデータベースにある場合、SSPROP_COL_UDT_CATALOGNAME プロパティと SSPROP_COL_UDT_SCHEMANAME プロパティの両方を指定する必要があります。

OLE DB で UDT をサポートするため、SQL Server Native Client では、ISSCommandWithParameters インターフェイスの追加など、多数の変更が加えられました。この新しいインターフェイスは、主要な OLE DB インターフェイス ICommandWithParameters から継承されます。ICommandWithParameters インターフェイスから継承される 3 つのメソッド (GetParameterInfo、MapParameterNames、および SetParameterInfo) に加えて、ISSCommandWithParameters インターフェイスでは、サーバー固有のデータ型を処理する GetParameterProperties メソッドと SetParameterProperties メソッドが提供されます。

注
また、ISSCommandWithParameters インターフェイスでは、新しい SSPARAMPROPS 構造体も使用されます。

ISSCommandWithParameters インターフェイス以外にも、SQL Server Native Client により、IColumnsRowset::GetColumnRowset メソッドの呼び出しで返される行セットに、次の新しい値が追加されます。

DBCOLUMN_TYPE を DBTYPE_UDT に設定すると、上記の新しく追加された UDT メタデータを参照することにより、サーバーの UDT 列と他のバイナリ型列とを区別することができます。そのデータが部分的に完成している場合、サーバーのデータ型は UDT になります。サーバーのデータ型が UDT 以外の場合、これらの列は、常に NULL として返されます。