Compartilhar via


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

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 comprimento constante e não permitir valores nulos (por exemplo, srvbit ou srvint1), cbLen será ignorado. Um valor de 0 significará dados de zero comprimentos 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á.

Retorna

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çaVocê deve examinar detalhadamente o código-fonte de procedimentos armazenados estendidos e deve 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.