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

Important

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et modifiez dès que possible 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. Lorsque NULL est retourné *len a la valeur 0.

Valeurs retournées

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

Remarque relative à la sécurité
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.