srv_pfield (API de procedimento armazenado estendido)

Aplica-se a:SQL Server

Importante

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Use a integração CLR em vez disso.

Retorna informações sobre uma conexão de banco de dados.

Sintaxe

  
DBCHAR * srv_pfield (  
SRV_PROC *  
srvproc  
,  
int   
field  
,  
int *  
len  
);  

Argumentos

srvproc
Ponteiro que identifica uma conexão de banco de dados.

field
Especifica dados na conexão que será retornada.

Valor	Retornos
SRV_APPLNAME	O nome dó aplicativo fornecido pelo cliente quando estabeleceu a conexão.
SRV_BCPFLAG	Um sinalizador que será TRUE se o cliente estiver se preparando para uma operação de cópia em massa; caso contrário, será FALSE.
SRV_CLIB	O nome da biblioteca que permite ao cliente falar com um servidor.
SRV_CPID	A ID de processo de cliente no computador original de cliente.
SRV_HOST	O nome do computador do cliente fornecido pelo cliente quando estabeleceu a conexão.
SRV_LIBVERS	A versão da biblioteca do cliente.
SRV_LSECURE	Um sinalizador. TRUE se a conexão usava segurança integrada para fazer logon.
SRV_NETWORK_MODULE	O nome da DLL de Biblioteca de Rede usado pela conexão.
SRV_NETWORK_VERSION	A versão da DLL de Biblioteca de Rede usada pela conexão.
SRV_NETWORK_CONNECTION	A cadeia de conexão passada para a DLL de Net-Library usada para a conexão srvproc atual.
SRV_PIPEHANDLE	Uma cadeia de caracteres que contém o controle de pipe de um cliente conectado ou NULL se o cliente estiver conectado em uma rede que não usa pipes nomeados. Para usar esse identificador como um identificador de pipe válido com o Microsoft Windows, converta essa cadeia de caracteres em um inteiro.
SRV_RMTSERVER	O servidor do qual o processo de cliente fez logon. Se o logon for de um cliente, esse valor será uma cadeia de caracteres vazia.
SRV_ROWSENT	O número de linhas já enviadas por srvproc para o conjunto atual de resultados.
SRV_SPID	A ID de thread do servidor do srvproc. Para obter procedimentos armazenados estendidos, esse valor será igual à coluna kpid de sys.sysprocesses e pode mudar ao longo do tempo.
SRV_SPROC_CODEPAGE	Página de código que o servidor usa para interpretar dados multibyte.
SRV_STATUS	O status atual de srvproc: em execução ou fechado
SRV_TYPE	O tipo de conexão de srvproc. Se o servidor for retornado, srvproc será de uma instância do SQL Server. Se o cliente for retornado, srvproc será proveniente de um cliente ODBC ou DB-Library.
SRV_USER	O nome do usuário da conexão.

len
É um ponteiro para uma variável int que contém o tamanho do valor de field retornado. Se len for NULL, o tamanho da cadeia de caracteres não será retornado.

Retornos

Um ponteiro para uma cadeia de caracteres terminada por caractere nulo que contém o valor atual do campo especificado na estrutura SRV_PROC. Se o campo for vazio, um ponteiro válido para uma cadeia de caracteres vazia será retornado e len conterá 0. Se o campo for desconhecido, NULL será retornado e len conterá o valor -1.

Importante

Você deve examinar totalmente o código-fonte de procedimentos armazenados estendidos e deve testar as DLLs compiladas antes de instalá-las em um servidor de produção. Para obter informações sobre análise e teste de segurança, consulte a Central de Desenvolvedores de Segurança.