srv_pfieldex (API delle stored procedure estese)

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 un puntatore ai dati che contengono il campo SRV_PROC richiesto.

Sintassi

void *srv_pfieldex(SRV_PROC * 
srvproc
, int 
field
, int * 
len
);

Argomenti

• srvproc
  Puntatore alla struttura SRV_PROC che rappresenta l'handle di una determinata connessione client. La struttura contiene informazioni utilizzate dalla libreria di API delle stored procedure estese per gestire le comunicazioni e i dati tra l'applicazione e il client.

• field
  Specifica il campo srvproc da restituire.

  Campo	Descrizione	Tipo restituito
  SRV_MSGLCID	LCDI di messaggio della sessione corrente.	ULONG*
  SRV_INSTANCENAME	Nome dell'istanza (se si tratta di un'istanza denominata); in caso contrario, restituisce NULL.	WCHAR*

• len
  Puntatore a una variabile int che contiene la lunghezza in byte del valore field restituito. Se len è NULL, la lunghezza non viene restituita. Quando viene restituito NULL, *len è impostato su 0.

Valori restituiti

Un puntatore ai dati il cui tipo dipende da field. Viene restituito NULL se len è NULL o srvproc è NULL. Se field non è noto, viene restituito NULL. Quando viene restituito NULL, *len è impostato su 0.

Nota sulla sicurezza
Il buffer restituito dal server deve essere di sola lettura. In caso contrario, lo stato del server può risultare danneggiato.

Osservazioni

Nota sulla protezione   È 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 sull'analisi di protezione, visitare questo sito Web Microsoft.