srv_describe (genişletilmiş saklı yordam API)
.gif "Important note") Important Note: |
|---|
This feature will be removed in a future version of Microsoft SQL Server. Do not use this feature in new development work, and modify applications that currently use this feature as soon as possible. CLR tümleştirme kullanın. |
Sütun adı, kaynak ve hedef veri türleri için belirli bir sütun, satırda tanımlar.
int srv_describe (
SRV_PROC *
srvproc
,
int
colnumber
,
DBCHAR *
column_name
,
int
namelen
,
DBINT
desttype
,
DBINT
destlen
,
DBINT
srctype
,
DBINT
srclen
,
void *
srcdata
);
Bağımsız değişkenler
srvproc
(Bu örnekte, satır gönderen istemci) belirli bir istemci bağlantısı için tanıtıcı SRV_PROC yapı işaretçisini iş.Yapısını, genişletilmiş saklı yordamının API kitaplığı iletişim ve uygulama ve istemci arasında verileri yönetmek için kullandığı bilgileri içerir.colnumber
Şu anda destekleniyor mu değil.Sütunları sırayla açıklanan gerekir.Tüm sütunları önce açıklanan gerekir srv_sendrow olarak adlandırılır.column_name
Adını belirtir sütun verilerin ait olduğu.sütun bir adı olması gerekmez, çünkü bu parametre null olabilir.namelen
Uzunluğu (bayt olarak belirtir column_name. If namelen SRV_NULLTERM, ise column_name boşlukla sonlandırılmış olmalıdır.desttype
Hedef satır sütunun veri türünü belirtir.Bu istemciye gönderilen veri türüdür.Veri türü olmalıdır verileri null olsa da, belirtilen, daha fazla bilgi için bkz: Veri türleri (genişletilmiş saklı yordam API).destlen
Istemciye gönderilecek verileri bayt olarak belirtir.Sabit uzunluklu veri türlerinde, null değerlere izin vermiyor destlen göz ardı edilir. Değişken uzunluklu veri türü ve da null değerler sabit uzunluklu veri türü destlen en fazla uzunluk hedef veri belirtir.srctype
Kaynak verilerin veri türünü belirtir.srclen
Kaynak verilerinin bayt olarak belirtir.Sabit uzunluklu veri türleri için bu değer yoksayılır.srcdata
Kaynak veri adresi, belirli bir sütun için sağlar.Ne zaman srv_sendrow adında, verilerini ararcolnumber AT srcdata. Bu nedenle, bir çaðrý önce serbest. srv_sendrow.Çağrı arasında veri kaynak adresi değiştirilebilir. srv_sendrow by using srv_setcoldata.Için ayrılan bellek srcdata sütun veri için başka bir çağrı tarafından değiştirilene kadar serbest. srv_setcoldata, or until srv_senddone olarak adlandırılır.If desttype SRVDECIMAL veya SRVNUMERIC, srcdata Parametre işaretçisi duyarlık ve ölçeği alanların yapısını DBNUMERIC veya DBDECIMAL yapısıyla zaten olmalıdır küme için istediğiniz değerleri. DEFAULTPRECISION, bir varsayılan duyarlık ve ölçeği varsayılan olarak belirlenecek DEFAULTSCALE belirtmek için kullanabilirsiniz.
Verir
Açıklanan sütun sayısı.Sütun 1 ilk sütundur.Bir hata oluşursa, 0 değerini döndürür.
Remarks
The srv_describe işlev must be called once for each sütun in the row before the first call to srv_sendrow.Bir satır, sütun, herhangi bir sırada tanımlanabilir.
Tam bir sonuç kümesi göndermeden önce kaynak verilerde sütun satır uzunluğunu ve konumunu değiştirmek için kullanın. srv_setcoldata and srv_setcollen, sırasıyla.
Veri türleri ve depolama yordamının API genişletilmiş veri türü dönüşümlerinin açıklaması için bkz:Veri türleri (genişletilmiş saklı yordam API).
Sütun adı uygulamanızdaki Unicode'dur, önce arama sunucusunun çok baytlı kod sayfa dönüştürme gerekir srv_describe.Daha fazla bilgi için bkz:Unicode veri ve sunucu kod sayfaları.
.gif "Security note") Security Note: |
|---|
Genişletilmiş depolanmış yordamların kaynak kodunu derinlemesine gözden geçirmelisiniz ve derlenmiş DLL'leri bir üretim sunucusuna yüklemeden önce onları sınamalısınız.Bu güvenlik incelemesi ve sınama hakkında daha fazla bilgi için bkz: Microsoft Web sitesini. |