Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a: 
SQL ServerBase de Dados SQL do AzureAzure SQL Managed InstanceAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)
O driver ODBC do SQL Server Native Client estende o SQLGetStmtAttr para expor atributos de instruções específicas do driver.
SQLSetStmtAttr lista atributos de instruções que são tanto leitura como escrita. Este tópico lista os atributos de instruções apenas de 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 a localização do comando no lote. O valor ValuePtr é do tipo SQLLEN.
SQL_SOPT_SS_NOCOUNT_STATUS
O atributo SQL_SOPT_SS_NOCOUNT_STATUS indica a definiçã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 | Description |
|---|---|
| SQL_NC_OFF | NOCOUNT está DESLIGADO. O SQLRowCount devolve o número de linhas afetadas. |
| SQL_NC_ON | NOCOUNT está LIGADO. O número de linhas afetadas não é devolvido pelo SQLRowCount e o valor devolvido é 0. |
Se o SQLRowCount devolver 0, a aplicação deve testar SQL_SOPT_SS_NOCOUNT_STATUS. Se SQL_NC_ON for devolvido, o valor de 0 do SQLRowCount indica apenas que SQL Server não devolveu a contagem de linhas. Se SQL_NC_OFF for devolvido, significa que NOCOUNT está desligado e o valor 0 do SQLRowCount indica que a instrução não afetou nenhuma linha.
As aplicações não devem mostrar o valor do SQLRowCount quando SQL_SOPT_SS_NOCOUNT_STATUS está SQL_NC_OFF. Grandes lotes ou procedimentos armazenados podem conter múltiplas SET NOCOUNT instruções, pelo que não se pode assumir que SQL_SOPT_SS_NOCOUNT_STATUS permanecem constantes. Esta opção deve ser testada sempre que o SQLRowCount devolver 0.
SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT
O atributo SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT devolve o texto da mensagem para o pedido de notificação da consulta.
SQLGetStmtAttr e parâmetros com valores de tabela
O SQLGetStmtAttr pode ser chamado para obter o valor de SQL_SOPT_SS_PARAM_FOCUS no descritor de parâmetros de aplicação (APD) ao trabalhar com parâmetros de valores de tabela. Para mais informações sobre SQL_SOPT_SS_PARAM_FOCUS, consulte SQLSetStmtAttr.
Para mais informações sobre parâmetros com valores de tabela, veja Table-Valued Parâmetros (ODBC).