Compartilhar via

srv_paramsetoutput (API de procedimento armazenado estendido)

  • Artigo

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.

Define o valor de um parâmetro de retorno. Essa função substitui a função srv_paramset.

Sintaxe

  
int srv_paramsetoutput (  
SRV_PROC *  
srvproc  
,  
int  
n  
,  
BYTE *  
pbData  
,  
ULONG   
cbLen  
,  
BOOL  
fNull   
);

Argumentos

srvproc
É um identificador para uma conexão do cliente.

n
É o número ordinal do parâmetro que será definido. O primeiro parâmetro é 1.

pbData
É um ponteiro para o valor dos dados que será enviado de volta ao cliente como um parâmetro de retorno do procedimento.

cbLen
É o comprimento real dos dados que serão retornados. Se o tipo de dados do parâmetro especificar valores de um tamanho constante e não permitir valores nulos (por exemplo, srvbit ou srvint1), cbLen será ignorado. Um valor igual a 0 significará dados de comprimento zero se fNull for FALSE.

fNull
É um sinalizador que indica se o valor do parâmetro de retorno é o NULL. Defina este sinalizador como TRUE se o parâmetro for definido como NULL. O valor padrão é FALSE. Se fNull for definido como TRUE, cbLen deverá ser definido como 0 ou a função falhará.

Devoluções

Se as informações de parâmetro tiverem sido definidas com êxito, SUCCEED será retornado. Caso contrário, o retorno será FAIL. FAIL é retornado quando

  • o parâmetro não é um parâmetro de retorno ou

  • o argumento cbLen é inválido.

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.