SQL Server Native Client의 OLE DB 테이블 반환 매개 변수 형식 지원(메서드)

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System(PDW)

다음 표준 OLE DB 메서드는 테이블 반환 매개 변수를 지원합니다.

Method 테이블 반환 매개 변수 지원
ITableDefinitionWithConstraints::CreateTableWithConstraints 테이블 반환 매개 변수의 형식 정보를 알고 있고 형식 정보를 기반으로 테이블 반환 매개 변수 행 집합 개체를 인스턴스화하려는 경우에 사용됩니다.

자세한 내용은 테이블 반환 매개 변수 행 집합 만들기의 "정적 시나리오"를 참조하세요.
IOpenRowset::OpenRowset 테이블 반환 매개 변수의 형식 정보를 알지 못하며 서버에서 검색된 메타데이터 정보를 기반으로 테이블 반환 매개 변수 행 집합 개체를 인스턴스화하려는 경우 사용합니다.

자세한 내용은 테이블 반환 매개 변수 행 집합 만들기의 "동적 시나리오"를 참조하세요.
ISSCommandWithParameters::SetParameterInfo 테이블 반환 매개 변수의 명령 매개 변수를 지정하려면 소비자가 DBPARAMBINDINFO 구조체의 pwszName 멤버에서 매개 변수 형식을 "table" 또는 "DBTYPE_TABLE"로 지정합니다. ulParamSize는 ~0으로 설정됩니다. 자세한 내용은 테이블 반환 매개 변수를 포함하는 실행 명령의 "테이블 반환 매개 변수 사양"을 참조하세요.
ISSCommandWithParameters::SetParameterProperties 스키마 이름, 유형 이름, 열 순서, 기본 열과 같은 테이블 반환 매개 변수와 관련된 속성을 설정합니다.

소비자가 SSPARAMPROPS 구조체의 iOrdinal에서 매개 변수의 서수를 지정합니다. 요청되는 속성 집합은 DBPROPSET_SQLSERVERPARAMETER입니다.
ISSCommandWithParameters::GetParameterInfo 모든 매개 변수 형식을 지정된 명령으로 가져옵니다.

테이블 반환 매개 변수의 경우 DBPARAMINFO 구조체의 wType 필드는 DBTYPE_TABLE 형식이 됩니다. ulParamSize 필드는 알 수 없는 길이를 나타내는 ~0으로 설정됩니다.
ISSCommandWithParameters::GetParameterProperties DBTYPE_TABLE 형식의 매개 변수에 대한 추가 형식 정보를 가져옵니다.

소비자는 SSPARAMPROPS 구조체의 iOrdinal 멤버에 있는 매개 변수의 서수를 지정합니다. 소비자는 ISSCommandWithParameters::SetParameterProperties 아래에 나열된 DBPROPSET_SQLSERVERPARAMETER 속성 집합의 속성을 요청할 수 있습니다.

소비자가 테이블 반환 매개 변수 형식을 모르기 때문에 공급자는 SSPROP_PARAM_TYPE_TYPENAME, SSPROP_PARAM_TYPE_SCHEMANAME 및 SSPROP_PARAM_TYPE_CATALOGNAME 올바른 값으로 설정해야 합니다. 나머지 SSPROP_PARAM_TABLE_DEFAULT_COLUMNS 및 SSPROP_PARAM_TABLE_COLUMN_SORT_ORDER 속성에는 기본값이 사용됩니다. 소비자가 테이블 반환 매개 변수 형식 이름을 검색한 후 IOpenRowset::OpenRowset을 사용하여 테이블 반환 매개 변수 형식의 이름을 지정하여 이 테이블 반환 매개 변수의 인스턴스를 만듭니다. 자세한 내용은 테이블 반환 매개 변수 형식 검색을 참조하세요.
IRowsetInfo::GetProperties 테이블 반환 매개 변수 행 집합 속성을 가져옵니다. 소비자는 이러한 속성을 사용하여 바인딩을 최적으로 설정할 수 있습니다.
IColumnsRowset::GetColumnsRowset SQL Server 테이블에 대한 메타데이터 정보를 검색합니다. 테이블 반환 매개 변수의 경우에는 동일한 인터페이스에서 다음과 같은 각 열에 대한 자세한 메타데이터 정보를 제공합니다.

DBCOLUMN_FLAGS는 DBCOLUMNFLAGS_ISNULLABLE 비트를 통해 Null 허용 여부를 나타냅니다.

DBCOLUMN_ISUNIQUE 열이 ID 열인지 여부를 나타냅니다.

DBCOLUMN_COMPUTEMODE 열이 계산되는지 여부를 나타냅니다.
IAccessor::CreateAccessor 테이블 반환 매개 변수 행 집합 개체를 명령 매개 변수에 바인딩하려면 해당 wType 멤버를 DBTYPE_TABLE로 설정하여 접근자를 만듭니다. DBOBJECT 구조체에는 IID_IRowset 또는 iid 멤버의 기타 유효한 행 집합 개체 인터페이스가 포함됩니다. 나머지 필드는 DBTYPE_IUNKNOWN 비슷하게 처리됩니다.

참고 항목

OLE DB 테이블 반환 매개 변수 형식 지원
테이블 반환 매개 변수 행 집합 만들기
테이블 반환 매개 변수 사용(OLE DB)