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

  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 comprimento do valor de field retornado, em bytes. Se len for NULL, o comprimento não será retornado. Quando NULL for retornado, *len é definido como 0.

Retorna

Um ponteiro para dados cujo tipo depende de field. NULL é retornado quando len for NULL ou srvproc for NULL. Se o field for desconhecido, NULL é retornado. Quando NULL for retornado, *len é definido como 0.

Observação sobre segurança
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çaVocê 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.