srv_pfield (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 des informations sur une connexion de base de données.
Syntaxe
DBCHAR * srv_pfield (
SRV_PROC *
srvproc
,
int
field
,
int *
len
);
Arguments
srvproc
Pointeur identifiant une connexion de base de données.
field
Spécifie des données sur la connexion à retourner.
| Valeur | Retours |
|---|---|
| SRV_APPLNAME | Nom d'application fourni par le client au moment d'établir la connexion. |
| SRV_BCPFLAG | Indicateur possédant la valeur TRUE si le client prépare une opération de copie en bloc ou la valeur FALSE dans le cas contraire. |
| SRV_CLIB | Nom de la bibliothèque permettant au client de communiquer avec un serveur. |
| SRV_CPID | ID de processus client sur l'ordinateur source client. |
| SRV_HOST | Nom de l'ordinateur client fourni par le client au moment d'établir la connexion. |
| SRV_LIBVERS | Version de la bibliothèque cliente. |
| SRV_LSECURE | Indicateur. Possède la valeur TRUE si la connexion a été établie au moyen de la sécurité intégrée. |
| SRV_NETWORK_MODULE | Nom de la DLL Net-Library utilisée par la connexion. |
| SRV_NETWORK_VERSION | Version de la DLL Net-Library utilisée par la connexion. |
| SRV_NETWORK_CONNECTION | Chaîne de connexion passée à la DLL Net-library employée pour la connexion srvproc actuelle. |
| SRV_PIPEHANDLE | Chaîne contenant le handle de canal d'un client connecté ou la valeur NULL si le client est connecté sur un réseau qui n'utilise pas de canaux nommés. Pour utiliser ce handle comme handle de canal valide avec Microsoft Windows, convertissez cette chaîne en entier. |
| SRV_RMTSERVER | Serveur à partir duquel le processus client est connecté. Si la connexion provient d'un client, cette valeur est une chaîne vide. |
| SRV_ROWSENT | Nombre de lignes déjà transmises par srvproc pour le jeu de résultats actuel. |
| SRV_SPID | ID de thread sur le serveur de srvproc. Pour les procédures stockées étendues, cette valeur est la même que celle de la colonne kpid de sys.sysprocesses et peut changer par la suite. |
| SRV_SPROC_CODEPAGE | Page de codes utilisée par le serveur pour interpréter les données multioctets. |
| SRV_STATUS | État actuel de srvproc : en cours d’exécution ou fermé. |
| SRV_TYPE | Type de connexion de srvproc. Si le serveur est retourné, srvproc provient d’une instance de SQL Server. Si le client est retourné, srvproc provient d’une bibliothèque de bases de données ou d’un client ODBC. |
| SRV_USER | Nom de l'utilisateur de la connexion. |
len
Pointeur vers une variable int contenant la longueur de la valeur field retournée. Si len a la valeur NULL; la longueur de la chaîne n’est pas retournée.
Retours
Pointeur vers une chaîne terminée par le caractère NULL contenant la valeur actuelle du champ spécifié dans la structure SRV_PROC. Si le champ est vide, un pointeur valide vers une chaîne vide est retourné et len contient la valeur 0. Si le champ est inconnu, la valeur NULL est retournée et len contient la valeur -1.
Important
Il est préférable d'examiner avec soin 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 cet examen et sur les tests de sécurité, consultez le site TechCenter sur la sécurité.