다음을 통해 공유


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

적용 대상: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)

OLE DB 드라이버 다운로드

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

메서드 테이블 반환 매개 변수 지원
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)