Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Il provider OLE DB di SQL Server Native Client interpreta le proprietà di inizializzazione e autorizzazione OLE DB come indicato di seguito:
| ID proprietà | Descrizione |
|---|---|
| DBPROP_AUTH_CACHE_AUTHINFO | Il provider OLE DB di SQL Server Native Client non memorizza nella cache le informazioni di autenticazione. Il provider OLE DB di SQL Server Native Client restituisce DB_S_ERRORSOCCURRED su un tentativo di impostare il valore della proprietà. Il membro dwStatus della struttura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_AUTH_ENCRYPT_PASSWORD | Il provider OLE DB di SQL Server Native Client usa meccanismi di sicurezza standard di MicrosoftSQL Server per nascondere le password. Il provider OLE DB di SQL Server Native Client restituisce DB_S_ERRORSOCCURRED su un tentativo di impostare il valore della proprietà. Il membro dwStatus della struttura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_AUTH_INTEGRATED | Se DBPROP_AUTH_INTEGRATED è impostato su un puntatore NULL, una stringa Null o un valore di VT_BSTR 'SSPI', il provider OLE DB di SQL Server Native Client usa la modalità di autenticazione di Windows per autorizzare l'accesso utente al database di SQL Server specificato dalle proprietà DBPROP_INIT_DATASOURCE e DBPROP_INIT_CATALOG. Se è impostato su VT_EMPTY (impostazione predefinita), viene usata la sicurezza di SQL Server. L'account di accesso e la password di SQL Server vengono specificati nelle proprietà DBPROP_AUTH_USERID e DBPROP_AUTH_PASSWORD. |
| DBPROP_AUTH_MASK_PASSWORD | Il provider OLE DB di SQL Server Native Client usa meccanismi di sicurezza standard di SQL Server per nascondere le password. Il provider OLE DB di SQL Server Native Client restituisce DB_S_ERRORSOCCURRED su un tentativo di impostare il valore della proprietà. Il membro dwStatus della struttura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_AUTH_PASSWORD | Password assegnata a un account di accesso di SQL Server. Questa proprietà viene utilizzata quando si seleziona l'autenticazione di SQL Server per autorizzare l'accesso a un database di SQL Server. |
| DBPROP_AUTH_PERSIST_ENCRYPTED | Il provider OLE DB di SQL Server Native Client non crittografa le informazioni di autenticazione quando è persistente. Il provider OLE DB di SQL Server Native Client restituisce DB_S_ERRORSOCCURRED su un tentativo di impostare il valore della proprietà. Il membro dwStatus della struttura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_AUTH_PERSISTENZA_INFORMAZIONI_AUTENTICAZIONE_SENSIBILE | Il provider OLE DB di SQL Server Native Client mantiene i valori di autenticazione, inclusa un'immagine di una password, se richiesto. Non viene fornita alcuna crittografia. |
| DBPROP_AUTH_USERID (identificativo utente per l'autenticazione) | Account di accesso di SQL Server. Questa proprietà viene utilizzata quando si seleziona l'autenticazione di SQL Server per autorizzare l'accesso a un database di SQL Server. |
| DBPROP_INIT_ASYNCH | Il provider OLE DB di SQL Server Native Client supporta l'avvio asincrono. L'impostazione del bit DBPROPVAL_ASYNCH_INITIALIZE nella proprietà DBPROP_INIT_ASYNCH fa sì che IDBInitialize::Initialize diventi una chiamata non bloccante. Per altre informazioni, vedere Esecuzione di operazioni asincrone. |
| DBPROP_INIT_CATALOG | Nome di un database DI SQL Server esistente a cui connettersi. |
| DBPROP_INIT_DATASOURCE | Nome di rete di un server che esegue un'istanza di MicrosoftSQL Server. Se nel computer sono in esecuzione più istanze di SQL Server, per connettersi a un'istanza specifica di SQL Server, il valore DBPROP_INIT_DATASOURCE viene specificato come \\ServerName\InstanceName. La sequenza di escape \\ viene usata per la barra rovesciata stessa. |
| DBPROP_INIT_GENERALTIMEOUT | Indica il numero di secondi prima di una richiesta, diversa dall'inizializzazione dell'origine dati e dall'esecuzione del comando, si verifica il timeout. Il valore 0 indica un timeout infinito. I provider che lavorano su connessioni di rete o in scenari distribuiti o transazionati possono supportare questa proprietà per consigliare a un componente incluso di scadere in caso di richiesta a esecuzione prolungata. I timeout per l'inizializzazione e l'esecuzione dei comandi dell'origine dati rimangono regolati rispettivamente da DBPROP_INIT_TIMEOUT e DBPROP_COMMANDTIMEOUT. DBPROP_INIT_GENERALTIMEOUT è di sola lettura e, se si tenta di impostarlo, viene restituito l'errore dwstatus di DBPROPSTATUS_NOTSETTABLE. |
| DBPROP_INIT_HWND | Handle di Windows dall'applicazione chiamante. Per la finestra di dialogo di inizializzazione visualizzata quando viene richiesto di inizializzare le proprietà di inizializzazione, è necessario un handle di finestra valido. |
| DBPROP_INIT_IMPERSONATION_LEVEL | Il provider OLE DB di SQL Server Native Client non supporta la regolazione del livello di rappresentazione. Il provider OLE DB di SQL Server Native Client restituisce DB_S_ERRORSOCCURRED su un tentativo di impostare il valore della proprietà. Il membro dwStatus della struttura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_INIT_LCID | Il provider OLE DB di SQL Server Native Client convalida l'ID delle impostazioni locali e restituisce un errore se l'ID delle impostazioni locali non è supportato o non è installato nel client. |
| DBPROP_INIT_LOCATION | Il provider OLE DB di SQL Server Native Client restituisce DB_S_ERRORSOCCURRED su un tentativo di impostare il valore della proprietà. Il membro dwStatus della struttura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_INIT_MODE | Il provider OLE DB di SQL Server Native Client restituisce DB_S_ERRORSOCCURRED su un tentativo di impostare il valore della proprietà. Il membro dwStatus della struttura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_INIT_PROMPT | Il provider OLE DB di SQL Server Native Client supporta tutte le modalità di richiesta per l'inizializzazione dell'origine dati. Il provider OLE DB di SQL Server Native Client usa DBPROMPT_NOPROMPT come impostazione predefinita per la proprietà . |
| DBPROP_INIT_PROTECTION_LEVEL | Il provider OLE DB di SQL Server Native Client non supporta un livello di protezione per le connessioni alle istanze di SQL Server. Il provider OLE DB di SQL Server Native Client restituisce DB_S_ERRORSOCCURRED su un tentativo di impostare il valore della proprietà. Il membro dwStatus della struttura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_INIT_PROVIDERSTRING | Vedere la stringa del provider OLE DB di SQL Server Native Client più avanti in questo argomento. |
| DBPROP_INIT_TIMEOUT | Il provider OLE DB di SQL Server Native Client restituisce un errore durante l'inizializzazione se non è possibile stabilire una connessione all'istanza di SQL Server entro il numero di secondi specificato. |
Nel set di proprietà specifico del provider DBPROPSET_SQLSERVERDBINIT, il provider OLE DB di SQL Server Native Client definisce queste proprietà di inizializzazione aggiuntive.
| ID proprietà | Descrizione |
|---|---|
| SSPROP_AUTH_OLD_PASSWORD | Tipo: VT_BSTR R/W: Scrittura Impostazione predefinita: VT_EMPTY Descrizione: password corrente o scaduta. Per altre informazioni, vedere Modifica delle password a livello di codice. |
| SSPROP_INIT_APPNAME | Tipo: VT_BSTR L/S: Lettura/Scrittura Descrizione: nome dell'applicazione client. |
| SSPROP_INIT_AUTOTRANSLATE | Tipo: VT_BOOL L/S: Lettura/Scrittura Impostazione predefinita: VARIANT_TRUE Descrizione: conversione di caratteri OEM/ANSI. VARIANT_TRUE: il provider OLE DB di SQL Server Native Client converte le stringhe di caratteri ANSI inviate tra il client e il server convertendo in Unicode per ridurre al minimo i problemi di corrispondenza dei caratteri estesi tra le tabelle codici nel client e il server: Il client DBTYPE_STR dati inviati a un'istanza di SQL Serverchar, varchar o variabile di testo , parametro o colonna viene convertito da carattere a Unicode usando la tabella codici ANSI client (ACP) e quindi convertita da Unicode a carattere usando l'ACP del server. I dati char, varchar o text di SQL Server inviati a un client DBTYPE_STR variabile vengono convertiti da carattere a Unicode usando il server ACP e quindi convertiti da Unicode a carattere usando l'ACP client. Queste conversioni vengono eseguite sul client dal provider OLE DB di SQL Server Native Client. Ciò richiede che lo stesso ACP usato nel server sia disponibile nel client. Queste impostazioni non hanno alcun effetto sulle conversioni che si verificano per questi trasferimenti: Unicode DBTYPE_WSTR dati client inviati a char, varchar o text nel server. dati del server ditesto, varchar o char inviati a una variabile di DBTYPE_WSTR Unicode nel client. ANSI DBTYPE_STR dati client inviati a Unicode nchar, nvarchar o ntext nel server. Dati del server di testo, varchar o char Unicode inviati a una variabile DBTYPE_STR ANSI nel client. VARIANT_FALSE: il provider OLE DB di SQL Server Native Client non esegue traduzioni di caratteri. Il provider OLE DB di SQL Server Native Client non converte il carattere ANSI client DBTYPE_STR dati inviati a variabili di tipo char, varchar o testo , parametri o colonne nel server. Nessuna traduzione viene eseguita su dati char, varchar o text inviati dal server a DBTYPE_STR variabili nel client. Se il client e l'istanza di SQL Server usano ACL diversi, i caratteri estesi possono essere interpretati in modo non corretto. |
| SSPROP_INIT_CURRENTLANGUAGE | Tipo: VT_BSTR L/S: Lettura/Scrittura Descrizione: nome della lingua di SQL Server. Identifica la lingua utilizzata per la selezione e la formattazione dei messaggi di sistema. La lingua deve essere installata nel computer che esegue un'istanza di SQL Server o l'inizializzazione dell'origine dati non riesce. |
| SSPROP_INIT_DATATYPECOMPATIBILITY | Tipo: VT_UI2 L/S: Lettura/Scrittura Impostazione predefinita: 0 Descrizione: abilita la compatibilità dei tipi di dati tra le applicazioni ADO (ActiveX Data Object) di SQL Server e ActiveX. Se viene utilizzato il valore predefinito 0, per impostazione predefinita la gestione del tipo di dati viene utilizzata dal provider. Se viene utilizzato il valore 80, la gestione dei tipi di dati usa solo i tipi di dati di SQL Server 2000. Per altre informazioni, vedere Uso di ADO con SQL Server Native Client. |
| SSPROP_INIT_ENCRYPT | Tipo: VT_BOOL L/S: Lettura/Scrittura Impostazione predefinita: VARIANT_FALSE Descrizione: per crittografare i dati in rete, SSPROP_INIT_ENCRYPT proprietà è impostata su VARIANT_TRUE. Se l'opzione Abilita crittografia protocollo è attivata, la crittografia verrà sempre eseguita, indipendentemente dall'impostazione di SSPROP_INIT_ENCRYPT. Se è disattivato e SSPROP_INIT_ENCRYPT è impostato su VARIANT_TRUE, verrà eseguita la crittografia. Se Enable Protocol Encryption è disattivato e SSPROP_INIT_ENCRYPT è impostato su VARIANT_FALSE, non viene eseguita alcuna crittografia. |
| SSPROP_INIT_FAILOVERPARTNER | Tipo: VT_BSTR L/S: Lettura/Scrittura Descrizione: specifica il nome del partner di failover per il mirroring del database. Si tratta di una proprietà di inizializzazione e può essere impostata solo prima dell'inizializzazione. Dopo l'inizializzazione, verrà restituito il partner di failover, se presente, restituito dal server primario. Ciò consente a un'applicazione intelligente di memorizzare nella cache il server di backup determinato più di recente, ma tali applicazioni devono tenere presente che le informazioni vengono aggiornate solo quando la connessione viene stabilita per la prima volta (o reimpostata, se in pool) e può diventare obsoleta per le connessioni a lungo termine. Dopo aver stabilito la connessione, l'applicazione può eseguire una query su questo attributo per determinare l'identità del partner di failover. Se il server primario non dispone di partner di failover, questa proprietà restituirà una stringa vuota. Per altre informazioni, vedere Uso del mirroring del database. |
| SSPROP_INIT_FILENAME | Tipo: VT_BSTR L/S: Lettura/Scrittura Descrizione: specifica il nome del file primario di un database collegabile. Questo database è collegato e diventa il database predefinito per la connessione. Per utilizzare SSPROP_INIT_FILENAME, è necessario specificare il nome del database come valore della proprietà di inizializzazione DBPROP_INIT_CATALOG. Se il nome del database non esiste, cerca il nome file primario specificato in SSPROP_INIT_FILENAME e collega il database con il nome specificato in DBPROP_INIT_CATALOG. Se il database è stato collegato in precedenza, SQL Server non lo ricollega. |
| SSPROP_INIT_MARSCONNECTION | Tipo: VT_BOOL L/S: Lettura/Scrittura Impostazione predefinita: VARIANT_FALSE Descrizione: specifica se per la connessione sono abilitati più set di risultati attivi (MARS). Questa opzione deve essere impostata su true prima che venga stabilita una connessione al database. Per altre informazioni, vedere Uso di MARS (Multiple Active Result Set). |
| SSPROP_INIT_NETWORKADDRESS | Tipo: VT_BSTR L/S: Lettura/Scrittura Descrizione: indirizzo di rete del server che esegue un'istanza di SQL Server specificata dalla proprietà DBPROP_INIT_DATASOURCE. |
| SSPROP_INIT_NETWORKLIBRARY | Tipo: VT_BSTR L/S: Lettura/Scrittura Descrizione: nome della libreria di rete (DLL) usata per comunicare con un'istanza di SQL Server. Il nome non deve includere il percorso o l'estensione del nome file .dll. L'impostazione predefinita può essere personalizzata usando l'utilità di configurazione client di SQL Server. Nota: Questa proprietà supporta solo TCP e Named Pipes. Se si utilizza questa proprietà con un prefisso, si ottiene un prefisso doppio che genera un errore, perché la proprietà viene usata per generare un prefisso internamente. |
| SSPROP_INIT_PACKETSIZE | Tipo: VT_I4 L/S: Lettura/Scrittura Descrizione: dimensioni in byte dei pacchetti di rete. Il valore della proprietà delle dimensioni del pacchetto deve essere compreso tra 512 e 32.767. Le dimensioni predefinite del pacchetto di rete del provider OLE DB di SQL Server Native Client sono 4.096. |
| SSPROP_INIT_TAGCOLUMNCOLLATION | Tipo: BOOL R/W: Scrittura Impostazione predefinita: FALSE Descrizione: viene utilizzato durante un aggiornamento del database quando vengono utilizzati cursori sul lato server. Questa proprietà contrassegna i dati con informazioni sulle regole di confronto ottenute dal server anziché dalla tabella codici nel client. Attualmente, questa proprietà viene utilizzata solo dal processo di query distribuito perché conosce le regole di confronto dei dati di destinazione e la converte correttamente. |
| SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Tipo: VT_BOOL L/S: Lettura/Scrittura Impostazione predefinita: VARIANT_FALSE Descrizione: usata per abilitare o disabilitare la convalida del certificato server. Questa proprietà è di lettura/scrittura, ma il tentativo di impostarlo dopo che è stata stabilita una connessione genererà un errore. Questa proprietà viene ignorata se il client è configurato per richiedere la convalida del certificato. Tuttavia, un'applicazione può usarla insieme a SSPROP_INIT_ENCRYPT per garantire che la connessione al server sia crittografata, anche se il client è configurato per non richiedere la crittografia e non viene effettuato alcun provisioning del certificato nel client. Le applicazioni client possono eseguire query su questa proprietà dopo l'apertura di una connessione per determinare le impostazioni di crittografia e convalida effettive in uso. Nota: L'uso della crittografia senza convalida dei certificati offre protezione parziale dall'analisi dei pacchetti, ma non da attacchi man-in-the-middle. Consente semplicemente di crittografare l'account di accesso e i dati inviati al server senza convalidare il certificato del server. Per altre informazioni, vedere Uso della crittografia senza convalida. |
| SSPROP_INIT_USEPROCFORPREP | Tipo: VT_I4 L/S: Lettura/Scrittura Impostazione predefinita: SSPROPVAL_USEPROCFORPREP_ON Descrizione: utilizzo della stored procedure di SQL Server. Definisce l'uso di stored procedure temporanee di SQL Server per supportare l'interfaccia ICommandPrepare . Questa proprietà è significativa solo quando ci si connette a SQL Server 6.5. La proprietà viene ignorata per le versioni successive. SSPROPVAL_USEPROCFORPREP_OFF: una stored procedure temporanea non viene creata quando viene preparato un comando. SSPROPVAL_USEPROCFORPREP_ON: viene creata una stored procedure temporanea quando viene preparato un comando. Le stored procedure temporanee vengono eliminate quando viene rilasciata la sessione. SSPROPVAL_USEPROCFORPREP_ON_DROP: viene creata una stored procedure temporanea quando viene preparato un comando. La procedura viene eliminata quando il comando non è preparato con ICommandPrepare::Unprepare, quando viene specificato un nuovo comando per l'oggetto comando con ICommandText::SetCommandText o quando vengono rilasciati tutti i riferimenti dell'applicazione al comando. |
| SSPROP_INIT_WSID | Tipo: VT_BSTR L/S: Lettura/Scrittura Descrizione: stringa che identifica la workstation. |
Nel set di proprietà specifico del provider DBPROPSET_SQLSERVERDATASOURCEINFO, il provider OLE DB di SQL Server Native Client definisce le proprietà aggiuntive; Per altre informazioni, vedere Proprietà delle informazioni sull'origine dati .
Stringa del provider OLE DB di SQL Server Native Client
Il provider OLE DB di SQL Server Native Client riconosce una sintassi simile a ODBC nei valori delle proprietà della stringa del provider. La proprietà della stringa del provider viene fornita come valore della proprietà di inizializzazione OLE DB DBPROP_INIT_PROVIDERSTRING quando viene stabilita una connessione all'origine dati OLE DB. Questa proprietà specifica i dati di connessione specifici del provider OLE DB necessari per implementare una connessione all'origine dati OLE DB. All'interno della stringa, gli elementi vengono delimitati usando un punto e virgola. L'elemento finale nella stringa deve essere terminato con un punto e virgola. Ogni elemento è costituito da una parola chiave, un carattere segno di uguale e il valore passato all'inizializzazione. Per esempio:
Server=MyServer;UID=MyUserName;
Con il provider OLE DB di SQL Server Native Client, il consumer non deve mai usare la proprietà della stringa del provider. Il consumer può impostare qualsiasi proprietà di inizializzazione riflessa nella stringa del provider usando le proprietà di inizializzazione specifiche del provider OLE DB o OLE DB di SQL Server Native Client.
Per un elenco delle parole chiave disponibili nel provider OLE DB di SQL Server Native Client, vedere Uso delle parole chiave della stringa di connessione con SQL Server Native Client.