SQLPutData
Kullanırken aşağıdaki sınırlamalar geçerlidir SQLPutData birden çok 65.535 bayt veri (göndermek için SQL Server sürüm 4.21a) veya 400 KB () bir SQL_LONGVARCHAR için veri (SQL Server sürüm 6.0 ve sonraki sürümleri)text), sql_wlongvarchar ()ntext) veya SQL_LONGVARBINARY ()image) sütun:
Başvurulan parametresi olabilir insert_value INSERT deyiminde.
Başvurulan parametresi olabilir bir expression bir UPDATE deyim küme yan tümcesinde.
Bir dizi iptal ediliyor SQLPutData bloklar halinde çalıştıran bir sunucuya veri aramaları SQL Server 6.5 veya önceki bir sürüm kullanırken, sütunun değeri, kısmi bir güncelleştirmenin neden olur. The text, ntext, or image sütun that was referenced when SQLCancel was called is küme to an intermediate placeholder value.
Not
The SQL Server Native istemci ODBC driver does not support connecting to SQL Server sürüm 6.5 and earlier.
Tanı
Biri yok SQL Server Yerel istemci belirli SQLSTATE için SQLPutData:
SQLSTATE |
Hata |
Açıklama |
|---|---|---|
22026 |
Verileri dize, uzunluk uyuşmazlığı |
Uzunluğunu bayt olarak gönderilecek veri varsa, ile SQL_LEN_DATA_AT_EXEC (örneğin, bir uygulama tarafından belirtilmişn) yeri n 0, uygulama tarafından verilen bayt sayısı çok büyük SQLPutData belirtilen uzunluk eşleşmesi gerekir. |
SQLPutData ve tablo biçiminde parametreleri
SQLPutData değişken satır bağlama tablo değerli parametreleri kullanılırken, bir uygulama tarafından kullanılır.The StrLen_Or_Ind parameter indicates that it is ready for the driver to collect data for the next row or rows of tablo-valued parameter data, or that no more rows are available:
0'Dan büyük BIR değer, bir sonraki satır değerleri kümesini kullanılabilir olduğunu gösterir.
0 Değeri gönderilecek daha fazla satır olduğunu gösterir.
0'Den küçük bir değer hata ise ve sonuçlar messaage "Geçersiz dize veya arabellek uzunluğu" SQLState HY090 ile oturum tanılama kayıttaki.
The DataPtr parameter is ignored, but must be küme to a non-NULL value. Daha fazla bilgi için değişken TVP satır bağlamasında bölümüne bakın... Bağlama ve verileri tablo biçiminde, Parametreler ve sütun değerleri Aktarım.
If StrLen_Or_Ind 0 ve SQL_PARAMSET_SIZE arasında bir sayı ya da SQL_DEFAULT_PARAM dışında bir değer vardır (yani, ColumnSize parametresi SQLBindParameter), bir hatadır. Bu hata, SQLPutData SQL_ERROR dönmek neden olur: SQLSTATE HY090, = "Dize veya arabellek uzunluğu geçersiz".
Tablo değerli parametreleri hakkında daha fazla bilgi için bkz: Tablo biçiminde Parametreler (ODBC).
Gelişmiş tarih ve saat özellikleri SQLPutData desteği
Tarih/saat türü parametre değerleri açıklandığı biçimde dönüştürülür... SQL için c dönüştürme.
Daha fazla bilgi için bkz: Geliştirmeler'nı (ODBC) tarih/saat.
Büyük bir CLR UDTs SQLPutData desteği
SQLPutData büyük CLR kullanıcı tanımlı türler (UDTs) destekler.Daha fazla bilgi için bkz:Büyük CLR kullanıcı tanımlı türler (ODBC).
Değişiklik Geçmişi
Güncelleştirilmiş içerik |
|---|
SQLSTATE 22026 ilgili bilgiler eklendi. |