Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O driver ODBC do SQL Server Native Client estende o SQLGetStmtAttr para expor atributos de instrução específicos do driver.
SQLSetStmtAttr lista atributos de instrução que são lidos e gravados. 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 NOCOUNT opção, que controla se SQL Server reporta o número de linhas afetadas por uma instrução quando o SQLRowCount é chamado. O valor ValuePtr é do tipo SQLLEN.
| Valor | Descrição |
|---|---|
| SQL_NC_OFF | NOCOUNT está DESLIGADO. SQLRowCount retorna o número de linhas afetadas. |
| SQL_NC_ON | NOCOUNT está LIGADO. 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 indica apenas que o SQL Server não retornou uma contagem de linhas. Se SQL_NC_OFF for retornado, significa que NOCOUNT está desligado e o valor de 0 do 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. Grandes lotes ou procedimentos armazenados podem conter múltiplas SET NOCOUNT instruções, então não se pode assumir que SQL_SOPT_SS_NOCOUNT_STATUS permanece 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 da mensagem para a solicitação de notificação de consulta.
Parâmetros com valor de tabela e SQLGetStmtAttr
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).
Consulte Também
Função SQLSetStmtAttr
Detalhes da implementação da API do ODBC