SQLGetStmtAttr
SQL Server Native Client ODBC 드라이버는 드라이버별 문 특성을 노출하도록 SQLGetStmtAttr을 확장합니다.
SQLSetStmtAttr에서는 읽기 및 쓰기 문 특성을 나열합니다. 이 항목에서는 읽기 전용 문 특성을 나열합니다.
SQL_SOPT_SS_CURRENT_COMMAND
SQL_SOPT_SS_CURRENT_COMMAND 특성은 명령 일괄 처리의 현재 명령을 노출합니다. 반환 값은 일괄 처리에서 명령의 위치를 지정하는 정수 값입니다. ValuePtr 값은 SQLLEN 유형입니다.
SQL_SOPT_SS_NOCOUNT_STATUS
SQL_SOPT_SS_NOCOUNT_STATUS 특성은 NOCOUNT 옵션의 현재 설정을 나타냅니다. 이 옵션은 SQLRowCount를 호출할 때 SQL Server가 문의 영향을 받는 행 수를 보고할지 여부를 제어합니다. ValuePtr 값은 SQLLEN 유형입니다.
값 |
설명 |
|---|---|
SQL_NC_OFF |
NOCOUNT가 OFF입니다. SQLRowCount가 영향을 받는 행 수를 반환합니다. |
SQL_NC_ON |
NOCOUNT가 ON입니다. SQLRowCount가 영향을 받는 행 수를 반환하지 않으며 반환되는 값은 0입니다. |
SQLRowCount가 0을 반환하면 응용 프로그램이 SQL_SOPT_SS_NOCOUNT_STATUS를 테스트해야 합니다. SQL_NC_ON이 반환되는 경우 SQLRowCount 값이 0이면 SQL Server에서 행 수를 반환하지 않았다는 것만 알 수 있습니다. SQL_NC_OFF가 반환되는 경우는 NOCOUNT가 OFF라는 의미이고 SQLRowCount 값이 0이면 문이 어떤 행에도 영향을 미치지 않는다는 것을 나타냅니다.
SQL_SOPT_SS_NOCOUNT_STATUS가 SQL_NC_OFF인 경우에는 응용 프로그램이 SQLRowCount 값을 표시하지 않습니다. 대규모 일괄 처리나 저장 프로시저에서는 여러 개의 SET NOCOUNT 문을 포함할 수 있으므로 SQL_SOPT_SS_NOCOUNT_STATUS가 일정하게 유지되지 않을 수 있습니다. 따라서 SQLRowCount가 0을 반환할 때마다 이 옵션을 테스트해야 합니다.
SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT
SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT 특성은 쿼리 알림 요청에 대한 메시지 텍스트를 반환합니다.
SQLGetStmtAttr 및 테이블 반환 매개 변수
테이블 반환 매개 변수로 작업할 때 SQLGetStmtAttr을 호출하여 APD(응용 프로그램 매개 변수 설명자)의 SQL_SOPT_SS_PARAM_FOCUS 값을 가져올 수 있습니다. SQL_SOPT_SS_PARAM_FOCUS에 대한 자세한 내용은 SQLSetStmtAttr을 참조하십시오.
테이블 반환 매개 변수에 대한 자세한 내용은 테이블 반환 매개 변수(ODBC)를 참조하십시오.