Compartilhar via

  • Artigo

srv_pfieldex (API de procedimento armazenado estendido)

Observação importanteImportante

Esse recurso será removido em uma versão futura de Microsoft SQL Server. Não utilize esse recurso em desenvolvimentos novos e planeje modificar, 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çaObservaçã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.