SQLProcedureColumns 함수

규칙
도입된 버전: ODBC 1.0 표준 준수: ODBC

요약
SQLProcedureColumns 입력 및 출력 매개 변수 목록과 지정된 프로시저에 대한 결과 집합을 구성하는 열을 반환합니다. 드라이버는 지정된 문에 대한 결과 집합으로 정보를 반환합니다.

통사론

  
SQLRETURN SQLProcedureColumns(  
     SQLHSTMT      StatementHandle,  
     SQLCHAR *     CatalogName,  
     SQLSMALLINT   NameLength1,  
     SQLCHAR *     SchemaName,  
     SQLSMALLINT   NameLength2,  
     SQLCHAR *     ProcName,  
     SQLSMALLINT   NameLength3,  
     SQLCHAR *     ColumnName,  
     SQLSMALLINT   NameLength4);  

인수

StatementHandle
[입력] 문 핸들입니다.

CatalogName
[입력] 프로시저 카탈로그 이름입니다. 드라이버가 다른 DBMS에서 데이터를 검색하는 경우와 같이 일부 프로시저에 대해 카탈로그를 지원하지만 다른 프로시저에서는 지원하지 않는 경우 빈 문자열("")은 카탈로그가 없는 프로시저를 나타냅니다. CatalogName 문자열 검색 패턴을 포함할 수 없습니다.

SQL_ATTR_METADATA_ID 문 특성이 SQL_TRUE 설정되면 CatalogName 식별자로 처리되고 해당 사례는 중요하지 않습니다. SQL_FALSE 경우 CatalogName 일반적인 인수입니다. 문자 그대로 처리되며 대/소문자도 중요합니다. 자세한 내용은 카탈로그 함수인수를 참조하세요.

NameLength1
[입력] *CatalogName문자의 길이입니다.

SchemaName
[입력] 프로시저 스키마 이름에 대한 문자열 검색 패턴입니다. 드라이버가 다른 DBMS에서 데이터를 검색하는 경우와 같이 일부 프로시저에 대한 스키마를 지원하지만 다른 프로시저에서는 지원하지 않는 경우 빈 문자열("")은 스키마가 없는 프로시저를 나타냅니다.

SQL_ATTR_METADATA_ID 문 특성이 SQL_TRUE 설정되면 SchemaName 식별자로 처리되며 해당 대/소문자는 중요하지 않습니다. SQL_FALSE 경우 SchemaName 패턴 값 인수입니다. 문자 그대로 처리되며 대/소문자도 중요합니다.

NameLength2
[입력] *SchemaName문자의 길이입니다.

procName
[입력] 프로시저 이름에 대한 문자열 검색 패턴입니다.

SQL_ATTR_METADATA_ID 문 특성이 SQL_TRUE 설정되면 ProcName 식별자로 처리되며 해당 대/소문자는 중요하지 않습니다. SQL_FALSE 경우 ProcName 패턴 값 인수입니다. 문자 그대로 처리되며 대/소문자도 중요합니다.

NameLength3
[입력] *ProcName문자의 길이입니다.

columnName
[입력] 열 이름에 대한 문자열 검색 패턴입니다.

SQL_ATTR_METADATA_ID 문 특성이 SQL_TRUE 설정된 경우 ColumnName 식별자로 처리되고 해당 사례는 중요하지 않습니다. SQL_FALSE 경우 columnName 패턴 값 인수입니다. 문자 그대로 처리되며 대/소문자도 중요합니다.

NameLength4
[입력] *ColumnName문자의 길이입니다.

반환

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_STILL_EXECUTING, SQL_ERROR 또는 SQL_INVALID_HANDLE.

진단

SQLProcedureColumns SQL_ERROR 또는 SQL_SUCCESS_WITH_INFO 반환하는 경우 SQL_HANDLE_STMT HandleTypeStatementHandleHandle 사용하여 SQLGetDiagRec 호출하여 관련 SQLSTATE 값을 가져올 수 있습니다. 다음 표에서는 SQLProcedureColumns 일반적으로 반환되는 SQLSTATE 값을 나열하고 이 함수의 컨텍스트에서 각각에 대해 설명합니다. "(DM)" 표기법은 드라이버 관리자가 반환한 SQLSTATE에 대한 설명 앞에 섰습니다. 달리 명시되지 않는 한 각 SQLSTATE 값과 연결된 반환 코드는 SQL_ERROR.

코멘트

이 함수는 일반적으로 문 실행 전에 프로시저 매개 변수 및 프로시저에서 반환된 결과 집합 또는 집합을 구성하는 열에 대한 정보를 검색하는 데 사용됩니다(있는 경우). 자세한 내용은 프로시저참조하세요.

SchemaName, ProcName및 ColumnName 인수는 검색 패턴을 허용합니다. 유효한 검색 패턴에 대한 자세한 내용은 패턴 값 인수참조하세요.

SQLProcedureColumns PROCEDURE_CAT, PROCEDURE_SCHEM, PROCEDURE_NAME 및 COLUMN_TYPE 따라 정렬된 표준 결과 집합으로 결과를 반환합니다. 열 이름은 반환 값의 이름, 프로시저 호출의 각 매개 변수 이름(호출 순서) 및 프로시저에서 반환된 결과 집합의 각 열 이름(열 순서)의 순서로 각 프로시저에 대해 반환됩니다.

애플리케이션은 결과 집합의 끝을 기준으로 드라이버별 열을 바인딩해야 합니다. 자세한 내용은 카탈로그 함수반환된 데이터를 참조하세요.

PROCEDURE_CAT, PROCEDURE_SCHEM, PROCEDURE_NAME 및 COLUMN_NAME 열의 실제 길이를 확인하기 위해 애플리케이션은 SQL_MAX_CATALOG_NAME_LEN, SQL_MAX_SCHEMA_NAME_LEN, SQL_MAX_PROCEDURE_NAME_LEN 및 SQL_MAX_COLUMN_NAME_LEN 옵션을 사용하여 SQLGetInfo 호출할 수 있습니다.

ODBC 3의 경우 다음 열의 이름이 바뀌었습니다. x. 열 이름 변경은 애플리케이션이 열 번호로 바인딩되므로 이전 버전과의 호환성에 영향을 미치지 않습니다.

ODBC 3에 SQLProcedureColumns 반환된 결과 집합에 다음 열이 추가되었습니다.x:

• COLUMN_DEF

• DATETIME_CODE

• CHAR_OCTET_LENGTH

• ORDINAL_POSITION

• IS_NULLABLE

다음 표에서는 결과 집합의 열을 나열합니다. 드라이버에서 열 19(IS_NULLABLE) 이외의 추가 열을 정의할 수 있습니다. 애플리케이션은 명시적 서수 위치를 지정하지 않고 결과 집합의 끝에서 카운트다운하여 드라이버별 열에 액세스할 수 있어야 합니다. 자세한 내용은 카탈로그 함수반환된 데이터를 참조하세요.

코드 예제

프로시저 호출참조하세요.

관련 함수

참고 항목

ODBC API 참조
ODBC 헤더 파일