SQLProcedureColumns

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

SQLProcedureColumns gibt eine Zeile zurück, die die Rückgabewertattribute aller SQL Server gespeicherten Prozeduren angibt.

SQLProcedureColumns gibt SQL_SUCCESS zurück, ob Werte für die Parameter CatalogName, SchemaName, ProcName oder ColumnName vorhanden sind. SQLFetch gibt SQL_NO_DATA zurück, wenn in diesen Parametern ungültige Werte verwendet werden.

SQLProcedureColumns können auf einem statischen Servercursor ausgeführt werden. Ein Versuch, SQLProcedureColumns auf einem aktualisierbaren Cursor (dynamisch oder keyset) auszuführen, gibt SQL_SUCCESS_WITH_INFO zurück, was angibt, dass der Cursortyp geändert wurde.

In der folgenden Tabelle sind die spalten aufgeführt, die vom Resultset zurückgegeben werden, und wie sie erweitert wurden, um die Datentypen udt und xml über den SQL Server Native Client ODBC-Treiber zu behandeln:

Spaltenname	BESCHREIBUNG
SS_UDT_CATALOG_NAME	Gibt den Namen des Katalogs zurück, der den benutzerdefinierten Typ (User-Defined Type, UDT) enthält.
SS_UDT_SCHEMA_NAME	Gibt den Namen des Schemas zurück, das den UDT enthält.
SS_UDT_ASSEMBLY_TYPE_NAME	Gibt den qualifizierten Namen des UDT-Assemblys zurück.
SS_XML_SCHEMACOLLECTION_CATALOG_NAME	Gibt den Namen des Katalogs zurück, in dem ein XML-Schemaauflistungsname definiert ist. Wenn der Katalogname nicht gefunden werden kann, enthält diese Variable eine leere Zeichenfolge.
SS_XML_SCHEMACOLLECTION_SCHEMA_NAME	Gibt den Namen des Schemas zurück, in dem ein XML-Schemaauflistungsname definiert ist. Wenn der Schemaname nicht gefunden werden kann, enthält diese Variable eine leere Zeichenfolge.
SS_XML_SCHEMACOLLECTION_NAME	Gibt den Namen einer XML-Schemaauflistung zurück. Wenn der Name nicht gefunden werden kann, enthält diese Variable eine leere Zeichenfolge.

SQLProcedureColumns und Tabellenwertparameter

SQLProcedureColumns verarbeitet Tabellenwertparameter ähnlich wie benutzerdefinierte CLR-Typen. In Zeilen, die für Tabellenwertparameter zurückgegeben werden, verfügen Spalten über die folgenden Werte:

Spaltenname	Beschreibung/Wert
DATA_TYPE	SQL_SS_TABLE
TYPE_NAME	Der Name des Tabellentyps für den Tabellenwertparameter.
COLUMN_SIZE	NULL
BUFFER_LENGTH	0
DECIMAL_DIGITS	Die Anzahl der Spalten im Tabellenwertparameter.
NUM_PREC_RADIX	NULL
NULLABLE	SQL_NULLABLE
ANMERKUNGEN	NULL
COLUMN_DEF	NULL. Tabellentypen könnten keine Standardwerte besitzen.
SQL_DATA_TYPE	SQL_SS_TABLE
SQL_DATEIME_SUB	NULL
CHAR_OCTET_LENGTH	NULL
IS_NULLABLE	"YES"
SS_TYPE_CATALOG_NAME	Gibt den Namen des Katalogs zurück, der die Tabelle oder den CLR-benutzerdefinierten Typ enthält.
SS_TYPE_SCHEMA_NAME	Gibt den Namen des Schemas zurück, das die Tabelle oder den CLR-benutzerdefinierten Typ enthält.

Die Spalten SS_TYPE_CATALOG_NAME und SS_TYPE_SCHEMA_NAME sind in SQL Server 2008 (10.0.x) und höheren Versionen verfügbar, um den Katalog bzw. das Schema für Tabellenwertparameter zurückzugeben. Dieses Spalten werden nicht nur mit Tabellenwertparametern sondern auch mit Parametern des CLR-benutzerdefinierten Typs aufgefüllt. (Vorhandene Schema- und Katalogspalten für benutzerdefinierte CLR-Typparameter sind von dieser zusätzlichen Funktionalität nicht betroffen. Sie werden auch aufgefüllt, um die Abwärtskompatibilität zu gewährleisten.

In Übereinstimmung mit der ODBC-Spezifikation werden SS_TYPE_CATALOG_NAME und SS_TYPE_SCHEMA_NAME vor allen treiberspezifischen Spalten angezeigt, die in früheren Versionen von SQL Server hinzugefügt wurden, und nach allen Von ODBC selbst vorgeschriebenen Spalten.

Weitere Informationen zu Tabellenwertparametern finden Sie unter Tabellenwertparameter (ODBC).

SQLProcedureColumns-Unterstützung für erweiterte Funktionen für Datum und Uhrzeit

Die für Datums-/Uhrzeittypen zurückgegebenen Werte finden Sie unter Katalogmetadaten.

Weitere allgemeine Informationen finden Sie unter Datums- und Uhrzeitverbesserungen (ODBC).

SQLProcedureColumns-Unterstützung für große CLR-UDTs

SQLProcedureColumns unterstützt große benutzerdefinierte CLR-Typen (UDTs). Weitere Informationen finden Sie unter Large CLR User-Defined Types (ODBC).

Weitere Informationen

SQLProcedureColumns-Funktion
ODBC API Implementation Details