OLE DB 테이블 반환 매개 변수 형식 지원(네이티브 클라이언트 OLE DB 공급자)

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

이 항목에서는 테이블 값 매개 변수에 대한 OLE DB 형식 지원에 대해 설명합니다.

테이블 반환 매개 변수 행 집합 개체

테이블 반환 매개 변수에 대한 특수한 행 집합 개체를 만들 수 있습니다. ITableDefinitionWithConstraints::CreateTableWithConstraints 또는 IOpenRowset::OpenRowset을 사용하여 테이블 반환 매개 변수 행 집합 개체를 만듭니다. 이렇게 하려면 pTableID 매개 변수의 eKind 멤버를 DBKIND_GUID_NAME으로 설정하고 CLSID_ROWSET_INMEMORY를 guid 멤버로 지정합니다. IOpenRowset::OpenRowset을 사용하는 경우 테이블 반환 매개 변수의 서버 형식 이름을 pTableID의 pwszName 멤버에 지정해야 합니다. 테이블 반환 매개 변수 행 집합 개체는 일반 SQL Server Native Client OLE DB 공급자 개체처럼 작동합니다.

const GUID CLSID_ROWSET_TVP =   
{0xc7ef28d5, 0x7bee, 0x443f, {0x86, 0xda, 0xe3, 0x98, 0x4f, 0xcd, 0x4d, 0xf9}};  
  
CoType RowsetTVP  
{  
[mandatory] interface IAccessor;  
[mandatory] interface IColumnsInfo;  
[mandatory] interface IConvertType;  
[mandatory] interface IRowset;  
[mandatory] interface IRowsetInfo;  
[optional]  interface IColumnsRowset;  
[optional]  interface IRowsetChange;  
[optional]  interface ISupportErrorInfo;  
};  

DBTYPE_TABLE

DBTYPE_TABLE 새 형식은 테이블 형식을 나타냅니다. 이 형식은 DBTYPE이 필요한 다양한 OLE DB 인터페이스에서 테이블 반환 매개 변수를 지정합니다.

#define DBTYPE_TABLE (143)  

DBTYPE_TABLE DBTYPE_IUNKNOWN 형식이 동일합니다. 데이터 버퍼의 개체에 대한 포인터입니다. 바인딩의 전체 사양을 위해 소비자는 iid를 행 집합 개체 인터페이스(IID_IRowset) 중 하나로 설정하여 DBOBJECT 버퍼를 채웁니다. 바인딩에 DBOBJECT가 지정되지 않은 경우 IID_IRowset 가정합니다.

DBTYPE_TABLE과 다른 형식 간의 변환은 지원되지 않습니다. IConvertType::CanConvert는 DBTYPE_TABLE 변환에 DBTYPE_TABLE 이외의 요청에 대해 지원되지 않는 변환에 대한 S_FALSE 반환합니다. 이는 명령 개체의 DBCONVERTFLAGS_PARAMETER로 간주됩니다.

메서드

테이블 반환 매개 변수를 지원하는 OLE DB 메서드에 관한 자세한 내용은 OLE DB 테이블 반환 매개 변수 형식 지원(메서드)을 참조하세요.

속성

테이블 반환 매개 변수를 지원하는 OLE DB 속성에 관한 자세한 내용은 OLE DB 테이블 반환 매개 변수 형식 지원(속성)을 참조하세요.

참고 항목

테이블 반환 매개 변수(OLE DB)
테이블 반환 매개 변수 사용(OLE DB)