다음을 통해 공유


핸들

핸들은 특정 항목을 식별하는 불투명 32비트 값입니다. ODBC에서 이 항목은 환경, 연결, 문 또는 설명자일 수 있습니다. 애플리케이션이 SQLAllocHandle을 호출할 때 드라이버 관리자 또는 드라이버는 지정된 형식의 새 항목을 만들고 해당 핸들을 애플리케이션에 반환합니다. 애플리케이션은 나중에 핸들을 사용하여 ODBC 함수를 호출할 때 해당 항목을 식별합니다. 드라이버 관리자와 드라이버는 핸들을 사용하여 항목에 대한 정보를 찾습니다.

예를 들어 다음 코드는 두 개의 문 핸들(hstmtOrderhstmtLine)을 사용하여 판매 주문 및 판매 주문 줄 번호의 결과 집합을 만들 문을 식별합니다. 나중에 이러한 핸들을 사용하여 데이터를 가져올 결과 집합을 식별합니다.

SQLHSTMT      hstmtOrder, hstmtLine; // Statement handles.  
SQLUINTEGER   OrderID;  
SQLINTEGER    OrderIDInd = 0;  
SQLRETURN     rc;  
  
// Prepare the statement that retrieves line number information.  
SQLPrepare(hstmtLine, "SELECT * FROM Lines WHERE OrderID = ?", SQL_NTS);  
  
// Bind OrderID to the parameter in the preceding statement.  
SQLBindParameter(hstmtLine, 1, SQL_PARAM_INPUT, SQL_C_ULONG, SQL_INTEGER, 5, 0,  
               &OrderID, 0, &OrderIDInd);  
  
// Bind the result sets for the Order table and the Lines table. Bind  
// OrderID to the OrderID column in the Orders table. When each row is  
// fetched, OrderID will contain the current order ID, which will then be  
// passed as a parameter to the statement tofetch line number  
// information. Code not shown.  
  
// Create a result set of sales orders.  
SQLExecDirect(hstmtOrder, "SELECT * FROM Orders", SQL_NTS);  
  
// Fetch and display the sales order data. Code to check if rc equals  
// SQL_ERROR or SQL_SUCCESS_WITH_INFO not shown.  
while ((rc = SQLFetch(hstmtOrder)) != SQL_NO_DATA) {  
   // Display the sales order data. Code not shown.  
  
   // Create a result set of line numbers for the current sales order.  
   SQLExecute(hstmtLine);  
  
   // Fetch and display the sales order line number data. Code to check  
   // if rc equals SQL_ERROR or SQL_SUCCESS_WITH_INFO not shown.  
   while ((rc = SQLFetch(hstmtLine)) != SQL_NO_DATA) {  
      // Display the sales order line number data. Code not shown.  
   }  
  
   // Close the sales order line number result set.  
   SQLCloseCursor(hstmtLine);  
}  
  
// Close the sales order result set.  
SQLCloseCursor(hstmtOrder);  

핸들은 핸들을 만든 ODBC 구성 요소에만 의미가 있습니다. 즉, 드라이버 관리자만 드라이버 관리자 핸들을 해석할 수 있고 드라이버만 자체 핸들을 해석할 수 있습니다.

예를 들어 앞의 예제에서 드라이버가 문에 대한 정보를 저장하는 구조를 할당하고 이 구조체에 대한 포인터를 문 핸들로 반환한다고 가정합니다. 애플리케이션이 SQLPrepare를 호출하면 판매 주문 줄 번호에 사용되는 문의 핸들과 SQL 문을 전달합니다. 드라이버는 SQL 문을 데이터 원본으로 전송하여 준비하고 액세스 계획 식별자를 반환합니다. 드라이버는 핸들을 사용하여 이 식별자를 저장할 구조를 찾습니다.

나중에 애플리케이션이 SQLExecute를 호출하여 특정 판매 주문에 대한 줄 번호의 결과 집합을 생성하면 동일한 핸들을 전달합니다. 드라이버는 핸들을 사용하여 구조에서 액세스 계획 식별자를 검색합니다. 식별자를 데이터 원본으로 전송하여 실행할 계획을 알려줍니다.

ODBC에는 드라이버 관리자 핸들과 드라이버 핸들의 두 가지 수준의 핸들이 있습니다. 애플리케이션은 드라이버 관리자에서 해당 함수를 호출하기 때문에 ODBC 함수를 호출할 때 드라이버 관리자 핸들을 사용합니다. 드라이버 관리자는 이 핸들을 사용하여 해당 드라이버 핸들을 찾고 드라이버에서 함수를 호출할 때 드라이버 핸들을 사용합니다. 드라이버 및 드라이버 관리자 핸들을 사용하는 방법에 대한 예제는 커넥트ion 프로세스에서 드라이버 관리자의 역할을 참조하세요.

두 가지 수준의 핸들이 있다는 것은 ODBC 아키텍처의 아티팩트입니다. 대부분의 경우 애플리케이션 또는 드라이버와 관련이 없습니다. 일반적으로 그렇게 할 이유가 없지만 애플리케이션에서 SQLGetInfo를 호출하여 드라이버 핸들을 확인할 수 있습니다.

이 섹션에서는 다음 항목을 다룹니다.