srv_pfieldex (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 um ponteiro para dados que contêm o campo SRV_PROC solicitado.
Sintaxe
void *srv_pfieldex(SRV_PROC *
srvproc
, int
field
, int *
len
);
Argumentos
srvproc
É um ponteiro para a estrutura SRV_PROC que atua como identificador de uma conexão de cliente específica. A estrutura contém informações que a biblioteca de APIs de procedimento armazenado estendido usa para gerenciar a comunicação e os dados entre o aplicativo e o cliente.
field
Especifica o campo srvproc a ser retornado.
Campo | Descrição | Tipo de retorno |
---|---|---|
SRV_MSGLCID | LCID de mensagem da sessão atual. | ULONG * |
SRV_INSTANCENAME | Nome de instância (se nomeado); caso contrário, retorna NULL. | WCHAR* |
len
É um ponteiro para uma variável int que contém o tamanho do valor de field retornado, em bytes. Se len for NULL, o tamanho não será retornado. Quando NULL é retornado, *len é definido como 0.
Devoluções
Um ponteiro para dados cujo tipo depende de field. NULL é retornado quando len é NULL ou srvproc é NULL. Se o field for desconhecido, NULL será retornado. Quando NULL é retornado, *len é definido como 0.
Importante
O buffer retornado pelo servidor deve ser somente leitura. Caso contrário, o estado do servidor pode estar corrompido.
Comentários
Observação de segurança Você deve examinar detalhadamente 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 testes de segurança, consulte este site da Microsoft.