IDBSchemaRowsetImpl : : CheckRestrictions

Article
06/10/2015

Vérifie la validité des restrictions par rapport à un jeu de lignes de schéma.

HRESULT CheckRestrictions( 
   REFGUID rguidSchema, 
   ULONG cRestrictions, 
   const VARIANT rgRestrictions[] 
);

Paramètres

rguidSchema
[in] référence à l'ensemble demandé de lignes de schéma GUID (par exemple, DBSCHEMA_TABLES).
cRestrictions
[in] nombre de restrictions que le consommateur a transmis pour l'ensemble de lignes de schéma.
rgRestrictions
[in] tableau de longueur cRestrictions des valeurs de restriction à définir. Pour plus d'informations, consultez la description du paramètre rgRestrictions dans SetRestrictions.

Notes

Utilisez CheckRestrictions pour vérifier la validité des restrictions par rapport à un jeu de lignes de schéma. Il vérifie les restrictions pour les ensembles de lignes de schéma DBSCHEMA_TABLES, DBSCHEMA_COLUMNS, et DBSCHEMA_PROVIDER_TYPES. Appelez-le pour déterminer si l'appel d'un consommateur à IDBSchemaRowset::GetRowset est correct. Si vous voulez prendre en charge des ensembles de lignes de schéma autres que ceux répertoriés ci-dessus, vous devez créer votre propre fonction pour effectuer cette tâche.

CheckRestrictions détermine si le consommateur appelle GetRowset avec la restriction appropriée et le type correct de restriction (par exemple, VT_BSTR pour une chaîne) que le fournisseur prend en charge. Il détermine également si le nombre correct de restrictions est pris en charge. Par défaut, CheckRestrictions demande au fournisseur, via l'appel à SetRestrictions, les restrictions qu'il prend en charge sur un ensemble de lignes donné. Il compare ensuite les restrictions du consommateur à celles prises en charge par le fournisseur et réussit ou échoue.

Pour des informations complémentaires sur les jeux de lignes de schéma, consultez IDBSchemaRowset dans OLE DB Programmer's Reference dans Kit de développement logiciel Windows.