srv_pfield (API de procedimento armazenado estendido)
Aplica-se:
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 | Devoluções |
|---|---|
| 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 número 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 server 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.
Devoluções
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.