srv_pfield (API de procedimento armazenado estendido)

Importante
Esse recurso será removido em uma versão futura do Microsoft SQL Server. Não utilize esse recurso em desenvolvimentos novos e modifique, assim que possível, os aplicativos que atualmente o utilizam. Em vez disso, use a integração CLR.

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	Retorna
  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 Biblioteca de Rede 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 controle como um controle 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 poderá se alterar com o 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á 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 comprimento do valor de field retornado. Se len for NULL, o comprimento da cadeia de caracteres não será retornado.

Retorna

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.

Observação sobre segurança
Você deve examinar cuidadosamente o código-fonte de procedimentos armazenados estendidos e testar as DLLs compiladas antes de instalá-las em um servidor de produção. Para obter informações sobre revisão e teste de segurança, consulte o Security Developer Center.