srv_paramset (genişletilmiş saklı yordam API)
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. |
Parametre kümeleri uzak saklı yordam çağrısı değerini döndürür.Bu işlev almıştır srv_paramsetoutput işlev.
int srv_paramset (
SRV_PROC *
srvproc
,
int
n
,
void *
data
,
int
len
);
Bağımsız değişkenler
srvproc
(Bu durumda, uzak saklı yordam çağrısı tanıtıcısı) belirli bir istemci bağlantısı için tanıtıcı SRV_PROC yapı işaretçisini belirtilir.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.n
Parametreyi gösterir küme.Ilk parametre 1'dir.data
Veri değeri geri gönderilmesi için bir işaretçi iş istemci uzak saklı yordam dönüş parametre.len
Döndürülecek verileri gerçek uzunluğunu belirtir.Parametrenin veri türünü sabit uzunluktadır ve null değerler (örneğin, izin vermiyor srvbit veya srvint1), len göz ardı edilir.
Verir
Parametre değeri başarıyla varsa BAŞARıLı küme; aksi halde, BAŞARıSıZ.BAŞARıSıZ olduğunda hiçbir geçerli uzak saklı yordam olduğunda döndürülen yok nth uzaktan yordam parametresi, parametre iade parametre olmadığında, saklanan len bağımsız değişken geçerli değil.
If lenis 0, it returns NULL.Ayar len NULL olarak geri almanın tek yolu sıfırdır istemci.
This function returns the following values, if the parameter is one of Microsoft SQL Server 2005 data types.
Yeni veri türleri |
Veri uzunluğu dönün. |
|---|---|
BITN |
null:len = 0, veri IG, RET = = 0 SIFIR: n/a >= 255: N/A <255: N/A |
BIGVARCHAR |
null:len = 0, veri IG, RET = = 1 SIFIR:len = IG, veri IG, RET = = 0 >=255:len = max8k, data = valid, RET = 0 <255:len = <8k, data = valid, RET = 1 |
BIGCHAR |
null:len = 0, veri IG, RET = = 1 SIFIR:len = IG, veri IG, RET = = 0 >=255:len = max8k, data = valid, RET = 0 <255:len = <8k, data = valid, RET = 1 |
BIGBINARY |
null:len = 0, veri IG, RET = = 1 SIFIR:len = IG, veri IG, RET = = 0 >=255:len = max8k, data = valid, RET = 0 <255:len = <8k, data = valid, RET = 1 |
BIGVARBINARY |
null:len = 0, veri IG, RET = = 1 SIFIR:len = IG, veri IG, RET = = 0 >=255:len = max8k, data = valid, RET = 0 <255:len = <8k, data = valid, RET = 1 |
nchar |
null:len = 0, veri IG, RET = = 1 SIFIR:len = IG, veri IG, RET = = 0 >=255:len = max8k, data = valid, RET = 0 <255:len = <8k, data = valid, RET = 1 |
nvarchar |
null:len = 0, veri IG, RET = = 1 SIFIR:len = IG, veri IG, RET = = 0 >=255:len = max8k, data = valid, RET = 0 <255:len = <8k, data = valid, RET = 1 |
NTEXT |
null:len = IG, veri IG, RET = = 0 SIFIR:len = IG, veri IG, RET = = 0 >=255:len = IG, data = IG, RET = 0 <255:len = IG, data = IG, RET = 0 |
RET = srv_paramset dönüş değeri |
|
IG = değer yoksayılacak |
|
Geçerli tüm geçerli veri işaretçisi = |
|
Remarks
Parametreler, istemcilerle uzaktan saklı yordamlar ile uygulama arasında aktarılan veriler içerir.Istemci, dönüş parametre olarak belirli parametreleri belirtebilirsiniz.Bu parametreler, Open Data Services sunucu uygulaması yeniden geçirir değerleri içerebilir dönmek istemci.Iade parametrelerini kullanarak parametreleri başvuruyla iletmek için ROM'una benzer.
Çağrılan işlenmemiş bir parametre için dönen değer, dönüş parametre olarak ayarlanamaz.Kullanabileceğiniz srv_paramstatus parametre nasıl başlatıldığı belirlenemiyor.
Bu işlevn dönüş değeri bir parametre için ayarlar ancak dönüş değeri için gerçekte göndermez istemci.Dönüş değerleri ile küme olup olmadığını parametrelerini, tüm iade srv_paramset veya yoksa, otomatik olarak istemciye gönderilen zaman srv_senddone durumu ile adlandırılır bayrak SRV_DONE_FINAL küme.
Parametrelerle uzak saklı yordam çağrısı yapıldığında, ad veya konum (adlandırılmamış) parametreleri geçirilebilir.Ad ve konuma göre geçirilen bazı tarafından geçirilen bazı parametreleri ile uzak saklı yordam çağrısı yapılırsa, hata oluşur.SRV_RPC işleyicisi hala olarak adlandırılır; ancak, herhangi bir parametre olan gibi görünür ve srv_rpcparams 0 değerini döndürür.
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. |
Important Note:
Security Note: