srv_pfieldex (API de procédure stockée étendue)

S’applique à : SQL Server

Important

Cette fonctionnalité sera supprimée dans une version future de SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Utilisez plutôt l'intégration du CLR.

Retourne un pointeur vers des données qui contiennent le champ SRV_PROC demandé.

Syntaxe

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

Arguments

srvproc
Pointeur vers la structure SRV_PROC qui est le handle pour une connexion cliente particulière. La structure contient des informations que la bibliothèque d'API de procédure stockée étendue utilise pour gérer les communications et les données entre l'application et le client.

field
Spécifie le champ srvproc à retourner.

Champ	Description	Type renvoyé
SRV_MSGLCID	LCID du message de la session active.	ULONG*
SRV_INSTANCENAME	Nom de l'instance (si elle est nommée) ; sinon, retourne NULL.	WCHAR*

len
Pointeur vers une variable int contenant la longueur de la valeur field retournée en octets. Si len a la valeur NULL, la longueur n’est pas retournée. Quand NULL est retourné *len a la valeur 0.

Retours

Pointeur vers des données dont le type dépend de field. NULL est retourné quand len a la valeur 0 ou quand srvproc a la valeur NULL. Si field est inconnu, la valeur NULL est retournée. Quand NULL est retourné *len a la valeur 0.

Important

La mémoire tampon retournée à partir du serveur doit être en lecture seule. Dans le cas contraire, l'état du serveur peut être endommagé.

Notes

Remarque relative à la sécurité Il est recommandé de revoir en détail le code source des procédures stockées étendues et de tester les DLL compilées avant de les installer sur un serveur de production. Pour plus d'informations sur l'examen et les tests de sécurité, consultez ce site Web de Microsoft.