SQLGetDescField
SQL Server Native Client ODBC 드라이버는 IRD(구현 행 설명자) 전용의 드라이버별 설명자 필드를 노출합니다. IRD 내에서 SQL Server 설명자 필드는 드라이버별 열 특성을 통해 참조됩니다. 사용 가능한 드라이버별 설명자 필드의 전체 목록에 대한 자세한 내용은 SQLColAttribute를 참조하십시오.
열 식별자 문자열이 포함된 설명자 필드는 대체로 길이가 0인 문자열입니다. SQL Server 관련 설명자 필드 값은 모두 읽기 전용입니다.
SQLColAttribute를 사용하여 검색된 특성과 마찬가지로 행 수준 특성(예: SQL_CA_SS_COMPUTE_ID)을 보고하는 설명자 필드는 결과 집합의 모든 열에 대해 보고됩니다.
SQLGetDescField 및 테이블 반환 매개 변수
SQLGetDescField를 사용하여 테이블 반환 매개 변수 및 테이블 반환 매개 변수 열의 확장 특성 값을 가져올 수 있습니다. 테이블 반환 매개 변수에 대한 자세한 내용은 테이블 반환 매개 변수(ODBC)를 참조하십시오.
향상된 날짜 및 시간 기능에 대한 SQLGetDescField 지원
새로운 날짜/시간 형식에 사용할 수 있는 설명자 필드에 대한 자세한 내용은 매개 변수 및 결과 메타데이터를 참조하십시오.
자세한 내용은 날짜/시간 기능 향상(ODBC)을 참조하십시오.
SQL Server 2012부터는 응용 프로그램에서 ODBC 3.8을 사용하는 경우 SQLGetDescField가 SQL_C_BINARY 대신 SQL_C_SS_TIME2(time 유형의 경우) 또는 SQL_C_SS_TIMESTAMPOFFSET(datetimeoffset의 경우)을 반환할 수 있습니다.
큰 CLR UDT에 대한 SQLGetDescField 지원
SQLGetDescField는 큰 CLR UDT(사용자 정의 형식)를 지원합니다. 자세한 내용은 큰 CLR 사용자 정의 형식(ODBC)을 참조하십시오.
스파스 열에 대한 SQLGetDescField 지원
SQLGetDescField는 새로운 IRD 필드인 SQL_CA_SS_IS_COLUMN_SET를 쿼리하여 열이 column_set 열인지 여부를 확인하는 데 사용할 수 있습니다.
자세한 내용은 스파스 열 지원(ODBC)을 참조하십시오.
예
typedef struct tagCOMPUTEBYLIST
{
SQLSMALLINT nBys;
SQLSMALLINT aByList[1];
} COMPUTEBYLIST;
typedef COMPUTEBYLIST* PCOMPUTEBYLIST;
SQLHDESC hIRD;
SQLINTEGER cbIRD;
SQLINTEGER nSet = 0;
// . . .
// Execute a statement that contains a COMPUTE clause,
// then get the descriptor handle of the IRD and
// get some IRD values.
SQLGetStmtAttr(g_hStmt, SQL_ATTR_IMP_ROW_DESC,
(SQLPOINTER) &hIRD, sizeof(SQLHDESC), &cbIRD);
// For statement-wide column attributes, any
// descriptor record will do. You know that 1 exists,
// so use it.
SQLGetDescField(hIRD, 1, SQL_CA_SS_NUM_COMPUTES,
(SQLPOINTER) &nComputes, SQL_IS_INTEGER, &cbIRD);
if (nSet == 0)
{
SQLINTEGER nOrderID;
printf_s("Normal result set.\n");
for (nCol = 0; nCol < nCols; nCol++)
{
SQLGetDescField(hIRD, nCol+1,
SQL_CA_SS_COLUMN_ORDER,
(SQLPOINTER) &nOrderID, SQL_IS_INTEGER,
&cbIRD);
if (nOrderID != 0)
{
printf_s("Col in ORDER BY, pos: %ld",
nOrderID);
}
printf_s("\n");
}
printf_s("\n");
}
else
{
PCOMPUTEBYLIST pByList;
SQLSMALLINT nBy;
SQLINTEGER nColID;
printf_s("Computed result set number: %lu\n",
nSet);
SQLGetDescField(hIRD, 1, SQL_CA_SS_COMPUTE_BYLIST,
(SQLPOINTER) &pByList, SQL_IS_INTEGER,
&cbIRD);
if (pByList != NULL)
{
printf_s("Clause ordered by columns: ");
for (nBy = 0; nBy < pByList->nBys; )
{
printf_s("%u", pByList->aByList[nBy]);
nBy++;
if (nBy == pByList->nBys)
{
printf_s("\n");
}
else
{
printf_s(", ");
}
}
}
else
{
printf_s("Compute clause set not ordered.\n");
}
for (nCol = 0; nCol < nCols; nCol++)
{
SQLGetDescField(hIRD, nCol+1,
SQL_CA_SS_COLUMN_ID, (SQLPOINTER) &nColID,
SQL_IS_INTEGER, &cbIRD);
printf_s("ColumnID: %lu, nColID);
}
printf_s("\n");
}
if (SQLMoreResults(g_hStmt) == SQL_SUCCESS)
{
// Determine the result set indicator.
SQLGetDescField(hIRD, 1, SQL_CA_SS_COMPUTE_ID,
(SQLPOINTER) &nSet, SQL_IS_INTEGER, &cbIRD);
}