Compartilhar via

srv_paraminfo (API de procedimento armazenado estendido)

  • Artigo

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 informações sobre um parâmetro. Essa função substitui as seguintes funções: srv_paramtype, srv_paramlen, srv_parammaxlen e srv_paramdata. srv_paraminfo dá suporte aos tipos de dados em Tipos de Dados e dados de comprimento zero.

Sintaxe

  
int srv_paraminfo (  
SRV_PROC *  
srvproc  
,  
int  
n  
,  
BYTE *  
pbType  
,  
ULONG *  
pcbMaxLen  
,  
ULONG *  
pcbActualLen  
,  
BYTE *  
pbData  
,  
BOOL *  
pfNull  
);

Argumentos

srvproc
Um identificador para uma conexão do cliente.

n
O número ordinal do parâmetro para ser definido. O primeiro parâmetro é 1.

pbType
O tipo de dados do parâmetro.

pcbMaxLen
Ponteiro para o comprimento máximo do parâmetro.

pcbActualLen
Ponteiro para o comprimento real do parâmetro. Um valor de 0 (*pcbActualLen == 0) significa dados de comprimento zero se *pfNull estiver definido como FALSE.

pbData
Ponteiro para o buffer para obter dados de parâmetro. Se pbData não for NULL, a API de Procedimento de Armazenamento Estendido gravará bytes de dados *pcbActualLen em *pbData. Se pbData for NULL, nenhum dado será gravado em *pbData , mas a função retornará *pbType, *pcbMaxLen, *pcbActualLen e *pfNull. A memória para este buffer deve ser gerenciada pelo aplicativo.

pfNull
Ponteiro para um sinalizador nulo. *pfNull será definido como TRUE se o valor do parâmetro for NULL.

Devoluções

Se a informações de parâmetro tiverem sido obtidas com êxito, SUCCEED será retornado. Caso contrário, o retorno será FAIL. FAIL será retornado quando não houver procedimento armazenado remoto atual e quando não houver parâmetro para o n-ésimo procedimento armazenado remoto.

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.

Confira também

Referência do programador de procedimentos armazenados estendidos