srv_paramname (拡張ストアド プロシージャ API)

適用対象:SQL Server

重要

この機能は、 SQL Serverの将来のバージョンで削除される予定です。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。 代わりに CLR 統合を使用してください。

リモート ストアド プロシージャ呼び出しのパラメーターの名前を返します。

構文

  
DBCHAR * srv_paramname (  
SRV_PROC * srvproc,intn, int *len );  

引数

srvproc
特定のクライアント接続のためのハンドル (この場合は、リモート ストアド プロシージャ呼び出しを受け取るハンドル) である SRV_PROC 構造体を指すポインターです。 この構造体には、アプリケーションとクライアントの間の通信やデータを管理するために、拡張ストアド プロシージャ API ライブラリで使用する情報が格納されます。

n
パラメーターの番号を示します。 最初のパラメーターは 1 です。

len
パラメーター名の長さ (バイト数) を格納した int 変数へのポインターです。 len が NULL である場合、リモート ストアド プロシージャのパラメーター名の長さは返されていません。

返品

パラメーター名を格納した NULL 終端文字列を指すポインターを返します。 パラメーター名の長さは、len に格納されます。 n 番目のパラメーターがない場合、またはリモート ストアド プロシージャがない場合は NULL を返し、len が -1 に設定され、情報エラー メッセージが送信されます。 パラメーター名が NULL である場合、len は 0 に設定され、NULL 終端の空文字列が返されます。

解説

この関数は、リモート ストアド プロシージャ呼び出しのパラメーターの名前を取得します。 パラメーターを指定してリモート ストアド プロシージャを呼び出す場合、パラメーターは名前で指定することも、名前を使用せずにその位置を指定して渡すこともできます。 名前によるパラメーター指定と位置によるパラメーター指定を混合してリモート ストアド プロシージャを呼び出すと、エラーが発生します。 エラーが発生しても SRV_RPC ハンドラーは呼び出されますが、パラメーターが存在しないと見なされ、srv_rpcparams は 0 を返します。

重要

拡張ストアド プロシージャのソース コードを十分に確認し、コンパイル済み DLL を、運用サーバーにインストールする前にテストする必要があります。 セキュリティの確認およびテストについて詳しくは、Microsoft の Web サイトをご覧ください。

参照

srv_rpcparams (拡張ストアド プロシージャ API)