Compartilhar via

  • Artigo

srv_paraminfo (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 informações sobre um parâmetro. Essa função substitui estas funções: srv_paramtype, srv_paramlen, srv_parammaxlen e srv_paramdata. srv_paraminfo oferece 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 comprimentos zero se *pfNull for definido como FALSE.

  • pbData
    Ponteiro para o buffer para obter dados de parâmetro. Se pbData não for o NULL, a API do procedimento de armazenado escreverá *os bytes de dados pcbActualLen como *pbData. Se pbData for o NULL, nenhum dado será escrito 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 o NULL.

Retorna

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º procedimento armazenado remoto.

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.