Share via

  • Article

srv_pfield (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 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

    Valeurs retournées

    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 employée par le serveur pour interpréter des 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.

Valeurs retournées

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.

Remarque relative à la sécuritéRemarque relative à la sécurité

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 Security Developer Center.