SQLGetStmtAttr
Aplica-se a: SQL Server
Banco de Dados
SQL do Azure Instância Gerenciada de SQL
do Azure PDW (Sistema de Plataforma de Análise) do Azure Synapse Analytics
O driver ODBC do SQL Server Native Client estende SQLGetStmtAttr para expor atributos de instrução específicos do driver.
SQLSetStmtAttr lista atributos de instrução que sejam de leitura e gravação. Este tópico lista os atributos de instrução somente leitura.
SQL_SOPT_SS_CURRENT_COMMAND
O atributo SQL_SOPT_SS_CURRENT_COMMAND expõe o comando atual de um lote de comando. O retorno é um inteiro que especifica o local do comando no lote. O valor ValuePtr é do tipo SQLLEN.
SQL_SOPT_SS_NOCOUNT_STATUS
O atributo SQL_SOPT_SS_NOCOUNT_STATUS indica a configuração atual da opção NOCOUNT, que controla se o SQL Server relata o número de linhas afetadas por uma instrução quando SQLRowCount é chamado. O valor ValuePtr é do tipo SQLLEN.
Valor | Descrição |
---|---|
SQL_NC_OFF | NOCOUNT é OFF. SQLRowCount retorna o número de linhas afetadas. |
SQL_NC_ON | NOCOUNT é ON. O número de linhas afetadas não é retornado por SQLRowCount e o valor retornado é 0. |
Se SQLRowCount retornar 0, o aplicativo deverá testar SQL_SOPT_SS_NOCOUNT_STATUS. Se SQL_NC_ON for retornado, o valor de 0 de SQLRowCount indicará apenas que o SQL Server não retornou uma contagem de linhas. Se SQL_NC_OFF for retornado, isso significa que NOCOUNT está desativado e o valor de 0 de SQLRowCount indica que a instrução não afetou nenhuma linha.
Os aplicativos não devem exibir o valor de SQLRowCount quando SQL_SOPT_SS_NOCOUNT_STATUS é SQL_NC_OFF. Lotes grandes ou procedimentos armazenados podem conter várias instruções SET NOCOUNT, portanto não é possível supor que SQL_SOPT_SS_NOCOUNT_STATUS permaneça constante. Essa opção deve ser testada sempre que SQLRowCount retornar 0.
SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT
O atributo SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT retorna o texto de mensagem para a solicitação de notificação de consulta.
SQLGetStmtAttr e Parâmetros com valor de tabela
SQLGetStmtAttr pode ser chamado para obter o valor de SQL_SOPT_SS_PARAM_FOCUS no APD (descritor de parâmetro de aplicativo) ao trabalhar com parâmetros com valor de tabela. Para obter mais informações sobre SQL_SOPT_SS_PARAM_FOCUS, consulte SQLSetStmtAttr.
Para obter mais informações sobre parâmetros com valor de tabela, consulte ODBC (Parâmetros com valor de tabela).
Confira também
Função SQLSetStmtAttr
Detalhes da implementação da API do ODBC
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários