srv_pfieldex (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 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.

Retornos

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.