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.