srv_pfield (API della stored procedure estesa)
Si applica a: 
SQL Server
Importante
Questa funzionalità verrà rimossa nelle versioni future di SQL Server. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. Usare invece l'integrazione 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 sicurezza 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 usata 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 usare questo handle come handle di pipe valido con Microsoft Windows, convertire questa stringa in un numero intero. |
| SRV_RMTSERVER | Server dal quale ha eseguito l'accesso il processo del 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 il server, srvproc proviene 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.
Importante
È 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 sicurezza, visitare il sito Web Security Developer Center.