srv_pfield (API della stored procedure estesa)

Importante
Questa caratteristica verrà rimossa a partire da una delle prossime versioni di Microsoft SQL Server. Non utilizzare questa caratteristica in un nuovo progetto di sviluppo e modificare non appena possibile le applicazioni in cui è attualmente implementata. Utilizzare invece la funzionalità di integrazione con CLR.

Restituisce informazioni su una connessione a un database.

Sintassi

DBCHAR * srv_pfield (
SRV_PROC *
srvproc
,
int 
field
,
int *
len
);

Argomenti

• srvproc
  Puntatore che identifica una connessione al database.

• field
  Specifica i dati nella connessione da restituire.

  Valore	Valori restituiti
  SRV_APPLNAME	Nome dell'applicazione fornito dal client quando ha stabilito la connessione.
  SRV_BCPFLAG	Flag impostato su TRUE se il client si prepara per un'operazione di copia bulk; in caso contrario, è impostato su FALSE.
  SRV_CLIB	Nome della libreria che consente al client di comunicare con un server.
  SRV_CPID	ID del processo client nel computer di origine client.
  SRV_HOST	Nome del computer del client fornito dal client quando ha stabilito la connessione.
  SRV_LIBVERS	Versione della libreria client.
  SRV_LSECURE	Flag. TRUE se la connessione utilizza protezione integrata per l'accesso.
  SRV_NETWORK_MODULE	Nome della DLL di rete utilizzata dalla connessione.
  SRV_NETWORK_VERSION	Versione della DLL di rete utilizzata dalla connessione.
  SRV_NETWORK_CONNECTION	Stringa di connessione passata alla DLL di rete utilizzata per la connessione srvproc corrente.
  SRV_PIPEHANDLE	Stringa che contiene l'handle di pipe di un client connesso oppure valore NULL se il client è connesso in una rete che non utilizza named pipe. Per utilizzare questo handle come handle di pipe valido con Microsoft Windows, convertire questa stringa in numero intero.
  SRV_RMTSERVER	Il server da cui viene eseguito l'accesso al processo client. Se l'accesso è da un client, questo valore è una stringa vuota.
  SRV_ROWSENT	Numero di righe già inviate da srvproc per il set di risultati corrente.
  SRV_SPID	ID del thread di server di srvproc. Per le stored procedure estese, questo valore coincide con quello della colonna kpid di sys.sysprocesses e può cambiare nel tempo.
  SRV_SPROC_CODEPAGE	Tabella codici utilizzata dal server per interpretare dati multibyte.
  SRV_STATUS	Stato corrente di srvproc: in esecuzione o chiusa.
  SRV_TYPE	Tipo di connessione di srvproc. Se viene restituito server, la connessione srvproc viene eseguita da un'istanza di SQL Server. Se viene restituito client, la connessione srvproc viene eseguita da DB-Library o da un client ODBC.
  SRV_USER	Nome utente della connessione.

• len
  Puntatore a una variabile int che contiene la lunghezza del valore field restituito. Se len è NULL, la lunghezza della stringa non viene restituita.

Valori restituiti

Un puntatore a una stringa con terminazione Null che contiene il valore corrente per il campo specificato nella struttura SRV_PROC. Se il campo è vuoto, viene restituito un puntatore valido a una stringa vuota e len contiene 0. Se il campo non è noto, viene restituito NULL e len contiene il valore -1.

Nota sulla sicurezza
È necessario esaminare con attenzione il codice sorgente delle stored procedure estese e testare le DLL compilate prima di installarle in un server di produzione. Per informazioni sui test e l'analisi della protezione, visitare il sito Web Security Developer Center.