Compartilhar via


SQLGetStmtAttr

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 comandos. 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 só indicará que SQL Server não retornou uma contagem de linha. Se SQL_NC_OFF for retornado, isso significa que NOCOUNT está desativado e o valor de 0 de SQLRowCount indicará que a instrução não afetou nenhuma linha.

Os aplicativos não deverão exibir o valor de SQLRowCount quando SQL_SOPT_SS_NOCOUNT_STATUS for 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. Esta 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

É possível chamar SQLGetStmtAttr para obter o valor de SQL_SOPT_SS_PARAM_FOCUS no APD (descritor de parâmetro de aplicativo) durante o trabalho 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 Parâmetros com valor de tabela (ODBC).

Histórico de alterações

Conteúdo atualizado

Atributos de leitura e gravação de instrução removidos e adicionada a informação de tipo ValuePtr.

Consulte também

Conceitos

Outros recursos