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 novos trabalhos de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. 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 identificando uma conexão de banco de dados.
campo
Especifica os dados sobre a conexão a ser retornada.
| Valor | Devoluções |
|---|---|
| SRV_APPLNAME | O nome do aplicativo fornecido pelo cliente quando estabeleceu a conexão. |
| SRV_BCPFLAG | Um sinalizador que é TRUE se o cliente estiver se preparando para uma operação de cópia em massa; caso contrário, FALSE. |
| SRV_CLIB | O nome da biblioteca que permite que o cliente fale com um servidor. |
| SRV_CPID | O ID do processo do cliente no computador de origem do cliente. |
| SRV_HOST | O nome da máquina do cliente fornecido pelo cliente quando estabeleceu a conexão. |
| SRV_LIBVERS | A versão da biblioteca do cliente. |
| SRV_LSECURE | Uma bandeira. TRUE se a conexão usou segurança integrada para fazer login. |
| SRV_NETWORK_MODULE | O nome da DLL Net-Library usada pela conexão. |
| SRV_NETWORK_VERSION | A versão da DLL Net-Library usada pela conexão. |
| SRV_NETWORK_CONNECTION | A cadeia de conexão passou para a DLL Net-Library usada para a conexão srvproc |
| SRV_PIPEHANDLE | Uma cadeia de caracteres que contém a alça de pipe de um cliente conectado, ou NULL se o cliente estiver conectado em uma rede que não usa pipes nomeados. Para usar essa alça como uma alça de pipe válida com o Microsoft Windows, converta essa cadeia de caracteres em um inteiro. |
| SRV_RMTSERVER | O servidor a partir do qual o processo do cliente está conectado. Se o login 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 | O ID de thread do servidor do srvproc. Para procedimentos armazenados estendidos, esse valor é o mesmo que a coluna kpid de sys.sysprocessese 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 do 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 DB-Library ou ODBC. |
| SRV_USER | O nome de usuário da conexão. |
len
É um ponteiro para uma variável int que contém o comprimento do campo retornado valor. Se len for NULL, o comprimento da cadeia de caracteres não será retornado.
Devoluções
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o valor atual para o campo especificado na estrutura SRV_PROC. Se o campo estiver 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 contiver o valor -1.
Importante
Você deve examinar cuidadosamente o código-fonte dos 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 testes de segurança, consulte o Security Developer Center.