目錄函式中的引數

  • 發行項

所有目錄函式都會接受引數，讓應用程式可以限制傳回的資料範圍。 例如，下列程式碼中的第一個和第二個 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 CatalogNameSchemaNameTableNameColumnName OA OA OA PV ID ID ID ID
SQLColumns CatalogNameSchemaNameTableNameColumnName OA PV PV PV ID ID ID ID
SQLForeignKeys PKCatalogNamePKSchemaNamePKTableNameFKCatalogNameFKSchemaNameFKTableName OA OA OA OA OA OA ID ID ID ID ID ID
SQLPrimaryKeys CatalogNameSchemaNameTableName OA OA OA ID ID ID
SQLProcedureColumns CatalogNameSchemaNameProcNameColumnName OA PV PV PV ID ID ID ID
SQLProcedures CatalogNameSchemaNameProcName OA PV PV ID ID ID
SQLSpecialColumns CatalogNameSchemaNameTableName OA OA OA ID ID ID
SQLStatistics CatalogNameSchemaNameTableName OA OA OA ID ID ID
SQLTablePrivileges CatalogNameSchemaNameTableName OA PV PV ID ID ID
SQLTables CatalogNameSchemaNameTableNameTableType PV PV PV VL ID ID ID VL

此章節包含下列主題。