Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Il s’agit des propriétés de l’ensemble de lignes du fournisseur OLE DB SQL Server Native Client.
| ID de propriété | Descriptif |
|---|---|
| DBPROP_ABORTPRESERVE | R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : Le comportement d’un ensemble de lignes après une opération d’abandon est déterminé par cette propriété. VARIANT_FALSE : le fournisseur OLE DB SQL Server Native Client invalide les ensembles de lignes après une opération d’abandon. La fonctionnalité de l’objet d’ensemble de lignes est presque perdue. Il prend uniquement en charge les opérations IUnknown et la mise en production de handles de ligne et d’accesseur en attente. VARIANT_TRUE : le fournisseur OLE DB SQL Server Native Client gère un ensemble de lignes valide. |
| DBPROP_ACCESSORDER | R/W : lecture/écriture Valeur par défaut : DBPROPVAL_AO_RANDOM Description : Ordre d’accès. Ordre dans lequel les colonnes doivent être accessibles sur l’ensemble de lignes. DBPROPVAL_AO_RANDOM : la colonne est accessible dans n’importe quel ordre. DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS : les colonnes liées en tant qu’objets de stockage ne sont accessibles qu’dans un ordre séquentiel déterminé par l’ordinal de colonne. DBPROPVAL_AO_SEQUENTIAL : toutes les colonnes doivent être accessibles dans l’ordre séquentiel déterminé par l’ordinal de colonne. |
| DBPROP_APPENDONLY | Cette propriété d’ensemble de lignes n’est pas implémentée par le fournisseur OLE DB SQL Server Native Client. La tentative de lecture ou d’écriture de la valeur de la propriété génère une erreur. |
| DBPROP_BLOCKINGSTORAGEOBJECTS | R/W : lecture seule Par défaut : VARIANT_TRUE Description : bloc d’objets de stockage du fournisseur OLE DB SQL Server Native Client à l’aide d’autres méthodes d’ensemble de lignes. |
| DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS | R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : le fournisseur OLE DB SQL Server Native Client prend en charge les signets pour l’identification des lignes de l’ensemble de lignes lorsque DBPROP_BOOKMARKS ou DBPROP_LITERALBOOKMARKS est VARIANT_TRUE. Définir l’une ou l’autre propriété sur VARIANT_TRUE n’active pas le positionnement de l’ensemble de lignes par signet. Définissez DBPROP_IRowsetLocate ou DBPROP_IRowsetScroll sur VARIANT_TRUE pour créer un ensemble de lignes prenant en charge le positionnement de l’ensemble de lignes par signet. Le fournisseur OLE DB SQL Server Native Client utilise un curseur Microsoft SQL Server pour prendre en charge un ensemble de lignes qui contient des signets. Pour plus d’informations, consultez Ensembles de lignes et curseurs SQL Server. Note: La définition de ces propriétés en conflit avec d’autres propriétés de définition de curseur du fournisseur OLE DB SQL Server Native Client provoque une erreur. Par exemple, la définition du DBPROP_BOOKMARKS sur VARIANT_TRUE lorsque DBPROP_OTHERINSERT est également VARIANT_TRUE génère une erreur lorsque le consommateur tente d’ouvrir un ensemble de lignes. |
| DBPROP_BOOKMARKSKIPPED | R/W : lecture seule Par défaut : VARIANT_FALSE Description : le fournisseur OLE DB SQL Server Native Client retourne DB_E_BADBOOKMARK si le consommateur indique un signet non valide lors du positionnement ou de la recherche d’un ensemble de lignes avec signet. |
| DBPROP_BOOKMARKTYPE | R/W : lecture seule Valeur par défaut : DBPROPVAL_BMK_NUMERIC Description : Le fournisseur OLE DB SQL Server Native Client implémente uniquement des signets numériques. Un signet de fournisseur OLE DB SQL Server Native Client est un entier non signé 32 bits, type DBTYPE_UI4. |
| DBPROP_CACHEDEFERRED | Cette propriété d’ensemble de lignes n’est pas implémentée par le fournisseur OLE DB SQL Server Native Client. La tentative de lecture ou d’écriture de la valeur de la propriété génère une erreur. |
| DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS | R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : le fournisseur OLE DB SQL Server Native Client prend en charge l’extraction descendante et le défilement dans les ensembles de lignes non référentiels. Le fournisseur OLE DB SQL Server Native Client crée un ensemble de lignes pris en charge par le curseur lorsque DBPROP_CANFETCHBACKWARDS ou DBPROP_CANSCROLLBACKWARDS est VARIANT_TRUE. Pour plus d’informations, consultez Ensembles de lignes et curseurs SQL Server. |
| DBPROP_CANHOLDROWS | R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : par défaut, le fournisseur OLE DB SQL Server Native Client retourne DB_E_ROWSNOTRELEASED si le consommateur tente d’obtenir davantage de lignes pour un ensemble de lignes alors que les modifications en attente existent sur celles actuellement dans l’ensemble de lignes. Ce comportement peut être modifié. Définir à la fois DBPROP_CANHOLDROWS et DBPROP_IRowsetChange sur VARIANT_TRUE implique un ensemble de lignes signet. Si les deux propriétés sont VARIANT_TRUE, l’interface IRowsetLocate est disponible sur l’ensemble de lignes et les DBPROP_BOOKMARKS et DBPROP_LITERALBOOKMARKS sont VARIANT_TRUE. Les ensembles de lignes du fournisseur OLE DB SQL Server Native Client qui contiennent des signets sont pris en charge par les curseurs SQL Server. |
| DBPROP_CHANGEINSERTEDROWS | R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : cette propriété ne peut être définie que sur VARIANT_TRUE si l’ensemble de lignes utilise un curseur piloté par l’ensemble de clés. |
| DBPROP_COLUMNRESTRICT | R/W : lecture seule Par défaut : VARIANT_FALSE Description : le fournisseur OLE DB SQL Server Native Client définit la propriété sur VARIANT_TRUE lorsqu’une colonne d’un ensemble de lignes ne peut pas être modifiée par le consommateur. D’autres colonnes de l’ensemble de lignes peuvent être mises à jour et les lignes elles-mêmes peuvent être supprimées. Lorsque la propriété est VARIANT_TRUE, le consommateur examine le membre dwFlags de la structure DBCOLUMNINFO pour déterminer si la valeur d’une colonne individuelle peut être écrite ou non. Pour les colonnes modifiables, dwFlags expose DBCOLUMNFLAGS_WRITE. |
| DBPROP_COMMANDTIMEOUT | R/W : lecture/écriture Valeur par défaut : 0 Description : par défaut, le fournisseur OLE DB SQL Server Native Client n’expire pas sur la méthode ICommand ::Execute . |
| DBPROP_COMMITPRESERVE | R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : Le comportement d’un ensemble de lignes après une opération de validation est déterminé par cette propriété. VARIANT_TRUE : le fournisseur OLE DB SQL Server Native Client gère un ensemble de lignes valide. VARIANT_FALSE : le fournisseur OLE DB SQL Server Native Client invalide les ensembles de lignes après une opération de validation. La fonctionnalité de l’objet d’ensemble de lignes est presque perdue. Il prend uniquement en charge les opérations IUnknown et la mise en production de handles de ligne et d’accesseur en attente. |
| DBPROP_DEFERRED | R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : lorsqu’il est défini sur VARIANT_TRUE le fournisseur OLE DB SQL Server Native Client tente d’utiliser un curseur de serveur pour l’ensemble de lignes. Les colonnes texte, ntext et image ne sont pas retournées par le serveur tant qu’elles ne sont pas accessibles par l’application. |
| DBPROP_DELAYSTORAGEOBJECTS | R/W : lecture seule Par défaut : VARIANT_FALSE Description : le fournisseur OLE DB SQL Server Native Client prend en charge le mode de mise à jour immédiate sur les objets de stockage. Les modifications apportées aux données d’un objet de flux séquentiel sont immédiatement soumises à SQL Server. Les modifications sont validées en fonction du mode transactionnel de l’ensemble de lignes. |
| DBPROP_HIDDENCOLUMNS | R/W : lecture seule Par défaut : VARIANT_FALSE Description: Nombre de colonnes masquées Si DBPROP_UNIQUEROWS est VARIANT_TRUE, la propriété DBPROP_HIDDENCOLUMNS retourne le nombre de colonnes « masquées » supplémentaires ajoutées par le fournisseur pour identifier de manière unique les lignes dans l’ensemble de lignes. Ces colonnes sont retournées par IColumnsInfo ::GetColumnInfo et IColumnsRowset ::GetColumnsRowset. Toutefois, ils ne sont pas inclus dans le nombre de lignes retournées par l’argument pcColumns retourné par IColumnsInfo ::GetColumnInfo. Pour déterminer le nombre total de colonnes représentées dans la structure prgInfo retournée par IColumnsInfo ::GetColumnInfo, y compris les colonnes masquées, le consommateur ajoute la valeur de DBPROP_HIDDENCOLUMNS au nombre de colonnes retournées par IColumnsInfo ::GetColumnInfo dans pcColumns. Si DBPROP_UNIQUEROWS est VARIANT_FALSE, DBPROP_HIDDENCOLUMNS est égal à zéro. |
| DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo | R/W : lecture seule Par défaut : VARIANT_TRUE Description : Le fournisseur OLE DB SQL Server Native Client prend en charge ces interfaces sur tous les ensembles de lignes. |
| DBPROP_IColumnsRowset | R/W : lecture/écriture Par défaut : VARIANT_TRUE Description : le fournisseur OLE DB SQL Server Native Client prend en charge l’interface IColumnsRowset . |
| DBPROP_IConnectionPointContainer | R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : IConnectionPointContainer. Si VARIANT_TRUE, l’ensemble de lignes prend en charge l’interface spécifiée. Si VARIANT_FALSE, l’ensemble de lignes ne prend pas en charge l’interface spécifiée. Les fournisseurs qui prennent en charge une interface doivent prendre en charge la propriété associée à cette interface avec une valeur de VARIANT_TRUE. Ces propriétés sont principalement utilisées pour demander des interfaces via ICommandProperties ::SetProperties. |
| DBPROP_IMultipleResults | R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : Le fournisseur OLE DB SQL Server Native Client prend en charge l’interface IMultipleResults . |
| DBPROP_IRowsetChange DBPROP_IRowsetUpdate | R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : Le fournisseur OLE DB SQL Server Native Client prend en charge les interfaces IRowsetChange et IRowsetUpdate . Un ensemble de lignes créé à l’aide de DBPROP_IRowsetChange égal à VARIANT_TRUE présente des comportements de mode de mise à jour immédiats. Lorsque DBPROP_IRowsetUpdate est VARIANT_TRUE, DBPROP_IRowsetChange est également VARIANT_TRUE. L’ensemble de lignes présente le comportement du mode de mise à jour différé. Le fournisseur OLE DB SQL Server Native Client utilise un curseur SQL Server pour prendre en charge les ensembles de lignes exposant IRowsetChange ou IRowsetUpdate. Pour plus d’informations, consultez Ensembles de lignes et curseurs SQL Server. |
| DBPROP_IRowsetIdentity | R/W : lecture/écriture Par défaut : VARIANT_TRUE Description : le fournisseur OLE DB SQL Server Native Client prend en charge l’interface IRowsetIdentity . Si un ensemble de lignes prend en charge cette interface, deux handles de ligne représentant la même ligne sous-jacente reflètent toujours les mêmes données et les mêmes états. Les consommateurs peuvent appeler la méthode IRowsetIdentity :: IsSameRow pour comparer deux handles de ligne pour voir s’ils font référence à la même instance de ligne. |
| DBPROP_IRowsetLocate DBPROP_IRowsetScroll | R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : le fournisseur OLE DB SQL Server Native Client peut exposer les interfaces IRowsetLocate et IRowsetScroll . Lorsque DBPROP_IRowsetLocate est VARIANT_TRUE, DBPROP_CANFETCHBACKWARDS et DBPROP_CANSCROLLBACKWARDS sont également VARIANT_TRUE. Lorsque DBPROP_IRowsetScroll est VARIANT_TRUE, DBPROP_IRowsetLocate est également VARIANT_TRUE, et les deux interfaces sont disponibles sur l’ensemble de lignes. Les signets sont requis pour l’une ou l’autre des interfaces. Le fournisseur OLE DB SQL Server Native Client définit DBPROP_BOOKMARKS et DBPROP_LITERALBOOKMARKS à VARIANT_TRUE lorsque le consommateur demande l’une ou l’autre interface. Le fournisseur OLE DB SQL Server Native Client utilise des curseurs SQL Server pour prendre en charge IRowsetLocate et IRowsetScroll. Pour plus d’informations, consultez Ensembles de lignes et curseurs SQL Server. La définition de ces propriétés en conflit avec d’autres propriétés de définition de curseur du fournisseur OLE DB SQL Server Native Client provoque une erreur. Par exemple, définir DBPROP_IRowsetScroll sur VARIANT_TRUE lorsque DBPROP_OTHERINSERT est également VARIANT_TRUE génère une erreur lorsque le consommateur tente d’ouvrir un ensemble de lignes. |
| DBPROP_IRowsetResynch | R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : le fournisseur OLE DB SQL Server Native Client expose l’interface IRowsetResynch à la demande. Le fournisseur OLE DB SQL Server Native Client peut exposer l’interface sur n’importe quel ensemble de lignes. |
| DBPROP_ISupportErrorInfo | R/W : lecture/écriture Par défaut : VARIANT_TRUE Description : le fournisseur OLE DB SQL Server Native Client expose l’interface ISupportErrorInfo sur les ensembles de lignes. |
| DBPROP_ILockBytes | Cette interface n’est pas implémentée par le fournisseur OLE DB SQL Server Native Client. La tentative de lecture ou d’écriture de la propriété génère une erreur. |
| DBPROP_ISequentialStream | R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : Le fournisseur OLE DB SQL Server Native Client expose l’interface ISequentialStream pour prendre en charge les données longues et de longueur variable stockées dans SQL Server. |
| DBPROP_IStorage | Cette interface n’est pas implémentée par le fournisseur OLE DB SQL Server Native Client. La tentative de lecture ou d’écriture de la propriété génère une erreur. |
| DBPROP_IStream | Cette interface n’est pas implémentée par le fournisseur OLE DB SQL Server Native Client. La tentative de lecture ou d’écriture de la propriété génère une erreur. |
| DBPROP_IMMOBILEROWS | R/W : lecture/écriture Par défaut : VARIANT_TRUE Description : La propriété n’est VARIANT_TRUE que pour les curseurs de jeu de clés SQL Server ; il est VARIANT_FALSE pour tous les autres curseurs. VARIANT_TRUE : l’ensemble de lignes ne réorganise pas les lignes insérées ou mises à jour. Pour IRowsetChange ::InsertRow, les lignes s’affichent à la fin de l’ensemble de lignes. Pour IRowsetChange ::SetData, si l’ensemble de lignes n’est pas ordonné, la position des lignes mises à jour n’est pas modifiée. Si l’ensemble de lignes est ordonné et que IRowsetChange ::SetData modifie une colonne utilisée pour classer l’ensemble de lignes, la ligne n’est pas déplacée. Si l’ensemble de lignes est basé sur un ensemble de colonnes clés (généralement un ensemble de lignes pour lequel DBPROP_OTHERUPDATEDELETE est VARIANT_TRUE mais DBPROP_OTHERINSERT est VARIANT_FALSE), la modification de la valeur d’une colonne clé équivaut généralement à supprimer la ligne actuelle et à en insérer une nouvelle. Par conséquent, la ligne peut sembler déplacer ou même disparaître de l’ensemble de lignes, si DBPROP_OWNINSERT est VARIANT_FALSE, même si la propriété DBPROP_IMMOBILEROWS est VARIANT_TRUE. VARIANT_FALSE : si l’ensemble de lignes est ordonné, les lignes insérées apparaissent dans l’ordre correct de l’ensemble de lignes. Si l’ensemble de lignes n’est pas ordonné, la ligne insérée apparaît à la fin. Si IRowsetChange ::SetData modifie une colonne utilisée pour classer l’ensemble de lignes, la ligne est déplacée. Si l’ensemble de lignes n’est pas ordonné, la position de la ligne n’est pas modifiée. |
| DBPROP_LITERALIDENTITY | R/W : lecture seule Par défaut : VARIANT_TRUE Description : Cette propriété est toujours VARIANT_TRUE. |
| DBPROP_LOCKMODE | R/W : lecture/écriture Par défaut : DBPROPVAL_LM_NONE Description : niveau de verrouillage effectué par l’ensemble de lignes (DBPROPVAL_LM_NONE, DBPROPVAL_LM_SINGLEROW). Note: Lorsque vous utilisez l’isolation d’instantané dans une transaction, si un ensemble de lignes est ouvert à l’aide d’un jeu de clés ou d’un curseur de serveur dynamique et que le mode de verrouillage est défini sur DBPROPVAL_LM_SINGLEROW, une erreur se produit lors de l’extraction d’une ligne si quelqu’un d’autre a mis à jour cette ligne depuis le démarrage de la transaction. Pour les autres types de curseurs et modes de verrouillage, si quelqu’un d’autre a mis à jour la ligne depuis le démarrage de la transaction, une erreur ne se produit pas tant que l’utilisateur ne tente pas de mettre à jour la ligne. Dans les deux cas, ces erreurs sont générées par le serveur. |
| DBPROP_MAXOPENROWS | R/W : lecture seule Valeur par défaut : 0 Description : le fournisseur OLE DB SQL Server Native Client ne limite pas le nombre de lignes pouvant être actives dans les ensembles de lignes. |
| DBPROP_MAXPENDINGROWS | R/W : lecture seule Valeur par défaut : 0 Description : Le fournisseur OLE DB SQL Server Native Client ne limite pas le nombre de lignes d’ensemble de lignes avec des modifications en attente. |
| DBPROP_MAXROWS | R/W : lecture/écriture Valeur par défaut : 0 Description : par défaut, le fournisseur OLE DB SQL Server Native Client ne limite pas le nombre de lignes d’un ensemble de lignes. Lorsque le consommateur définit DBPROP_MAXROWS, le fournisseur OLE DB SQL Server Native Client utilise l’instruction SET ROWCOUNT pour limiter le nombre de lignes de l’ensemble de lignes. SET ROWCOUNT peut entraîner des conséquences inattendues dans l’exécution d’instructions SQL Server. Pour plus d’informations, consultez SET ROWCOUNT. |
| DBPROP_MAYWRITECOLUMN | Cette propriété d’ensemble de lignes n’est pas implémentée par le fournisseur OLE DB SQL Server Native Client. La tentative de lecture ou d’écriture de la valeur de la propriété génère une erreur. |
| DBPROP_MEMORYUSAGE | Cette propriété d’ensemble de lignes n’est pas implémentée par le fournisseur OLE DB SQL Server Native Client. La tentative de lecture ou d’écriture de la valeur de la propriété génère une erreur. |
| DBPROP_NOTIFICATIONGRANULARITY | Cette propriété d’ensemble de lignes n’est pas implémentée par le fournisseur OLE DB SQL Server Native Client. La tentative de lecture ou d’écriture de la valeur de la propriété génère une erreur. |
| DBPROP_NOTIFICATIONPHASES | R/W : lecture seule Par défaut : DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO | DBPROPVAL_NP_SYNCHAFTER | DBPROPVAL_NP_FAILEDTODO | DBPROPVAL_NP_DIDEVENT Description : Le fournisseur OLE DB SQL Server Native Client prend en charge toutes les phases de notification. |
| DBPROP_NOTIFYCOLUMNSET DBPROP_NOTIFYROWDELETE DBPROP_NOTIFYROWFIRSTCHANGE DBPROP_NOTIFYROWINSERT DBPROP_NOTIFYROWRESYNCH DBPROP_NOTIFYROWSETRELEASE DBPROP_NOTIFYROWSETFETCH-POSITIONCHANGE DBPROP_NOTIFYROWUNDOCHANGE DBPROP_NOTIFYROWUNDODELETE DBPROP_NOTIFYROWUNDOINSERT DBPROP_NOTIFYROWUPDATE | R/W : lecture seule Par défaut : DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO Description : Les phases de notification du fournisseur OLE DB SQL Server Native Client sont annulables avant une tentative d’exécution de la modification de l’ensemble de lignes indiquée. Le fournisseur OLE DB SQL Server Native Client ne prend pas en charge l’annulation de phase une fois la tentative terminée. |
| DBPROP_ORDEREDBOOKMARKS | Cette propriété d’ensemble de lignes n’est pas implémentée par le fournisseur OLE DB SQL Server Native Client. La tentative de lecture ou d’écriture de la valeur de la propriété génère une erreur. |
| DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE | R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : La définition des propriétés de visibilité des modifications entraîne l’utilisation du fournisseur OLE DB SQL Server Native Client pour prendre en charge l’ensemble de lignes. Pour plus d’informations, consultez Ensembles de lignes et curseurs SQL Server. |
| DBPROP_QUICKRESTART | R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : lorsqu’il est défini sur VARIANT_TRUE, le fournisseur OLE DB SQL Server Native Client tente d’utiliser un curseur de serveur pour l’ensemble de lignes. |
| DBPROP_REENTRANTEVENTS | R/W : lecture seule Par défaut : VARIANT_TRUE Description : Les ensembles de lignes du fournisseur OLE DB SQL Server Native Client sont re-entrants et peuvent retourner DB_E_NOTREENTRANT si un consommateur tente d’accéder à une méthode d’ensemble de lignes non entrante à partir d’un rappel de notification. |
| DBPROP_REMOVEDELETED (suppression des éléments supprimés) | R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : le fournisseur OLE DB SQL Server Native Client modifie la valeur de la propriété en fonction de la visibilité des modifications apportées aux données SQL Server exposées par l’ensemble de lignes. VARIANT_TRUE : les lignes supprimées par le consommateur ou d’autres utilisateurs SQL Server sont supprimées de l’ensemble de lignes lorsque l’ensemble de lignes est actualisé. DBPROP_OTHERINSERT est VARIANT_TRUE. VARIANT_FALSE : les lignes supprimées par le consommateur ou d’autres utilisateurs SQL Server ne sont pas supprimées de l’ensemble de lignes lorsque l’ensemble de lignes est actualisé. La valeur d’état de ligne pour les lignes SQL Server supprimées dans l’ensemble de lignes est DBROWSTATUS_E_DELETED. DBPROP_OTHERINSERT est VARIANT_TRUE. Cette propriété a uniquement une valeur pour les ensembles de lignes pris en charge par les curseurs SQL Server. Pour plus d’informations, consultez Ensembles de lignes et curseurs SQL Server. Lorsque la propriété DBPROP_REMOVEDELETED est implémentée sur un ensemble de lignes de curseur de jeu de clés, les lignes supprimées sont supprimées au moment de l’extraction et il est possible pour les méthodes d’extraction de lignes, telles que GetNextRows et GetRowsAt, de retourner à la fois S_OK et moins de lignes que demandées. Notez que ce comportement ne signifie pas la condition de DB_S_ENDOFROWSET et que le nombre de lignes retournées ne sera jamais égal à zéro s’il y a des lignes restantes. |
| DBPROP_REPORTMULTIPLECHANGES | Cette propriété d’ensemble de lignes n’est pas implémentée par le fournisseur OLE DB SQL Server Native Client. La tentative de lecture ou d’écriture de la valeur de la propriété génère une erreur. |
| DBPROP_RETURNPENDINGINSERTS | R/W : lecture seule Par défaut : VARIANT_FALSE Description : Lorsqu’une méthode qui extrait des lignes est appelée, le fournisseur OLE DB SQL Server Native Client ne retourne pas de lignes d’insertion en attente. |
| DBPROP_ROWRESTRICT | R/W : lecture seule Par défaut : VARIANT_TRUE Description : les ensembles de lignes du fournisseur OLE DB SQL Server Native Client ne prennent pas en charge les droits d’accès en fonction de la ligne. Si l’interface IRowsetChange est exposée sur un ensemble de lignes, la méthode SetData peut être appelée par le consommateur. |
| DBPROP_ROWSET_ASYNCH | R/W : lecture/écriture Valeur par défaut : 0 Description : fournit le traitement de l’ensemble de lignes anychronous. Cette propriété se trouve dans le groupe de propriétés Rowset et DBPROPSET_ROWSET propriété set. Le type est VT_14. La seule valeur du masque de bits prise en charge par SQL Server Native Client est DBPROPVAL_ASYNCH_INITIALIZE. |
| DBPROP_ROWTHREADMODEL | R/W : lecture seule Par défaut : DBPROPVAL_RT_FREETHREAD Description : Le fournisseur OLE DB SQL Server Native Client prend en charge l’accès à ses objets à partir de plusieurs threads d’exécution d’un seul consommateur. |
| DBPROP_SERVERCURSOR | R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : lorsqu’il est défini, un curseur SQL Server est utilisé pour prendre en charge l’ensemble de lignes. Pour plus d’informations, consultez Ensembles de lignes et curseurs SQL Server. |
| DBPROP_SERVERDATAONINSERT | R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : Données du serveur lors de l’insertion. VARIANT_TRUE : au moment où une insertion est transmise au serveur, le fournisseur récupère les données du serveur pour mettre à jour le cache de ligne local. VARIANT_FALSE : le fournisseur ne récupère pas les valeurs du serveur pour les lignes nouvellement insérées. |
| DBPROP_STRONGIDENTITY | R/W : lecture seule Par défaut : VARIANT_TRUE Description : Identité de ligne forte. Si les insertions sont autorisées sur un ensemble de lignes ( IRowsetChange ou IRowsetUpdate a la valeur true) et que DBPROP_UPDATABILITY est défini pour prendre en charge InsertRows, la valeur de DBPROP_STRONGIDENTITY dépend de DBPROP_CHANGEINSERTEDROWS propriété (sera VARIANT_FALSE si DBPROP_CHANGEINSERTEDROWS valeur de propriété est VARIANT_FALSE). |
| DBPROP_TRANSACTEDOBJECT | R/W : lecture seule Par défaut : VARIANT_FALSE Description : Le fournisseur OLE DB SQL Server Native Client prend uniquement en charge les objets transactionnés. Pour plus d’informations, consultez Transactions. |
| DBPROP_UNIQUEROWS | R/W : lecture/écriture Par défaut : VARIANT_FALSE Description : lignes uniques. VARIANT_TRUE : chaque ligne est identifiée de manière unique par ses valeurs de colonne. L’ensemble de colonnes qui identifient de façon unique la ligne a le DBCOLUMNFLAGS_KEYCOLUMN défini dans la structure DBCOLUMNINFO retournée par la méthode GetColumnInfo . VARIANT_FALSE : les lignes peuvent ou ne pas être identifiées de manière unique par leurs valeurs de colonne. Les colonnes clés peuvent ou ne pas être marquées par DBCOLUMNFLAGS_KEYCOLUMN. |
| DBPROP_UPDATABILITY | R/W : lecture/écriture Valeur par défaut : 0 Description : Le fournisseur OLE DB SQL Server Native Client prend en charge toutes les valeurs DBPROP_UPDATABILITY. La définition DBPROP_UPDATABILITY ne crée pas d’ensemble de lignes modifiable. Pour rendre un ensemble de lignes modifiable, définissez DBPROP_IRowsetChange ou DBPROP_IRowsetUpdate. |
Le fournisseur OLE DB SQL Server Native Client définit le jeu de propriétés spécifique au fournisseur DBPROPSET_SQLSERVERROWSET comme indiqué dans ce tableau.
| ID de propriété | Descriptif |
|---|---|
| SSPROP_COLUMN_ID | Colonne : ColumnID R/W : lecture seule Type : VT_U12 | VT_ARRAY Par défaut : VT_EMPTY Description : tableau de valeurs entières représentant la position ordinale (basée sur 1) d’une colonne de résultat de clause COMPUTE dans l’instruction SELECT Transact-SQL actuelle. Il s’agit du fournisseur OLE DB SQL Server Native Client équivalent de l’attribut odbc SQL_CA_SS_COLUMN_ID. |
| SSPROP_DEFERPREPARE | Colonne : Non R/W : lecture/écriture Type : VT_BOOL Par défaut : VARIANT_TRUE Description : VARIANT_TRUE : lors de l’exécution préparée, la préparation de la commande est différée jusqu’à ce que ICommand ::Execute soit appelé ou qu’une opération de métapropriété soit effectuée. Si la propriété est définie sur VARIANT_FALSE : l’instruction est préparée lorsque ICommandPrepare ::P repare est exécuté. |
| SSPROP_IRowsetFastLoad | Colonne : Non R/W : lecture/écriture Type : VT_BOOL Par défaut : VARIANT_FALSE Description : définissez cette propriété sur VARIANT_TRUE pour ouvrir un ensemble de lignes de chargement rapide via IOpenRowset ::OpenRowset. Vous ne pouvez pas définir cette propriété dans ICommandProperties ::SetProperties. |
| SSPROP_ISSAsynchStatus | Colonne : Non. R/W : lecture/écriture Type : VT_BOOL Par défaut : VARIANT_FALSE Description : définissez cette propriété sur VARIANT_TRUE pour activer les opérations asynchrones à l’aide de l’interface ISSAsynchStatus . |
| SSPROP_MAXBLOBLENGTH | Colonne : Non R/W : lecture/écriture Type : VT_I4 Valeur par défaut : le fournisseur ne limite pas la taille du texte retourné par le serveur et la valeur de la propriété est définie sur sa valeur maximale. Par exemple, 2147483647. Description : Le fournisseur OLE DB SQL Server Native Client exécute une instruction SET TEXTSIZE pour restreindre la longueur des données BLOB (Binary Large Object) retournées dans une instruction SELECT. |
| SSPROP_NOCOUNT_STATUS | Colonne : NoCount R/W : lecture seule Type : VT_BOOL Par défaut : VARIANT_FALSE Description : valeur booléenne représentant l’état de SET NOCOUNT ON/OFF dans SQL Server : VARIANT_TRUE : quand SET NOCOUNT ON VARIANT_FALSE : quand SET NOCOUNT OFF |
| SSPROP_QP_NOTIFICATION_MSGTEXT | Colonne : Non R/W : lecture/écriture Type : VT_BSTR (1 à 2000 caractères autorisés) Valeur par défaut : chaîne vide Description : texte du message de la notification de requête. Il s’agit d’un format défini par l’utilisateur et n’a pas de format défini. |
| SSPROP_QP_NOTIFICATION_OPTIONS | Colonne : Non R/W : lecture/écriture Type : VT_BSTR Valeur par défaut : chaîne vide Description : options de notification de requête. Celles-ci sont spécifiées dans une chaîne avec name=value. L'utilisateur est chargé de créer le service et de lire les notifications de la file d'attente. La syntaxe de la chaîne des options de notifications de requêtes est :service=<service-name>[;(local database=<database>|broker instance=<broker instance>)]Par exemple: service=mySSBService;local database=mydb |
| SSPROP_QP_NOTIFICATION_TIMEOUT | Colonne : Non R/W : lecture/écriture Type : VT_UI4 Valeur par défaut : 432000 secondes (5 jours) Minimum : 1 secondes Maximum : 2^31-1 secondes Description : nombre de secondes pendant lesquelles la notification de requête doit rester active. |