目錄函式中的引數
所有目錄函式都會接受引數,讓應用程式可以限制傳回的資料範圍。 例如,下列程式碼中的第一個和第二個 SQLTable 呼叫會傳回包含所有資料表資訊的結果集,而第三個呼叫會傳回 Orders 資料表的相關資訊:
SQLTables(hstmt1, NULL, 0, NULL, 0, NULL, 0, NULL, 0);
SQLTables(hstmt2, NULL, 0, NULL, 0, "%", SQL_NTS, NULL, 0);
SQLTables(hstmt3, NULL, 0, NULL, 0, "Orders", SQL_NTS, NULL, 0);
目錄函式字串引數分為四種不同的類型:一般引數 (OA)、模式值引數 (PV)、識別碼引數 (ID),以及值清單引數 (VL)。 根據 SQL_ATTR_METADATA_ID 陳述式屬性的值,大部分的字串引數可以是兩種不同類型之一。 下表列出每個目錄函式的引數,並說明 SQL_ATTR_METADATA_ID 的 SQL_TRUE 或 SQL_FALSE 值的引數類型。
函式 | 引數 | 輸入時機:SQL_ ATTR_METADATA_ ID = SQL_FALSE |
輸入時機:SQL_ ATTR_METADATA_ ID = SQL_TRUE |
---|---|---|---|
SQLColumnPrivileges | CatalogName SchemaName TableName ColumnName | OA OA OA PV | ID ID ID ID |
SQLColumns | CatalogName SchemaName TableName ColumnName | OA PV PV PV | ID ID ID ID |
SQLForeignKeys | PKCatalogName PKSchemaName PKTableName FKCatalogName FKSchemaName FKTableName | OA OA OA OA OA OA | ID ID ID ID ID ID |
SQLPrimaryKeys | CatalogName SchemaName TableName | OA OA OA | ID ID ID |
SQLProcedureColumns | CatalogName SchemaName ProcName ColumnName | OA PV PV PV | ID ID ID ID |
SQLProcedures | CatalogName SchemaName ProcName | OA PV PV | ID ID ID |
SQLSpecialColumns | CatalogName SchemaName TableName | OA OA OA | ID ID ID |
SQLStatistics | CatalogName SchemaName TableName | OA OA OA | ID ID ID |
SQLTablePrivileges | CatalogName SchemaName TableName | OA PV PV | ID ID ID |
SQLTables | CatalogName SchemaName TableName TableType | PV PV PV VL | ID ID ID VL |
此章節包含下列主題。