Classe __ObjectProviderRegistration
La classe système abstraite __ObjectProviderRegistration sert de classe parente pour les classes utilisées pour inscrire des fournisseurs de classes et d’instances dans WMI.
La syntaxe suivante est simplifiée à partir de code au format MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés sont répertoriées dans l’ordre alphabétique, et non dans l’ordre MOF.
Syntaxe
[abstract]
class __ObjectProviderRegistration : __ProviderRegistration
{
sint32 InteractionType = 0;
__Provider REF provider;
string QuerySupportLevels[];
boolean SupportsBatching;
boolean SupportsDelete = False;
boolean SupportsEnumeration = False;
boolean SupportsGet = False;
boolean SupportsPut = False;
boolean SupportsTransactions;
};
Membres
La classe __ObjectProviderRegistration possède ces types de membres :
Propriétés
La classe __ObjectProviderRegistration possède les propriétés suivantes.
-
InteractionType
-
-
Type de données : sint32
-
Type d’accès : lecture/écriture
Indique si la classe ou le fournisseur d’instances fournit ses propres données ou s’appuie sur WMI et le référentiel Common Information Model (CIM). Les fournisseurs d’extraction prennent en charge l’accès dynamique à leurs données, et les fournisseurs d’émission stockent leurs données dans le référentiel CIM et s’appuient sur WMI pour y accéder. Pour plus d’informations, consultez Détermination de l’état d’émission ou d’extraction. La valeur par défaut est 0 (zéro).
-
-
Extraction (0)
-
Le fournisseur est un fournisseur d’extraction.
-
Émission (1)
-
Le fournisseur est un fournisseur d’émission.
-
Vérification d’émission (2)
-
Le fournisseur est un fournisseur de vérification d’émission. Veuillez noter que la vérification d’émission n’est pas prise en charge pour le moment.
provider
-
Type de données : __Provider
-
Type d'accès : Lecture seule
Référence à une instance de __Provider qui représente le chemin d’accès à un objet du fournisseur d’objets. Cette propriété est héritée de __ProviderRegistration.
QuerySupportLevels
-
Type de données : string array
-
Type d’accès : lecture/écriture
Tableau des types de prise en charge incluses par le fournisseur pour le traitement des requêtes. Les fournisseurs de classes ne prennent en charge aucun type de requête. Les fournisseurs d’instances peuvent définir QuerySupportLevels sur NULL s’ils ne prennent pas en charge le traitement des requêtes. Les fournisseurs qui prennent en charge les requêtes implémentent la méthode IWbemServices::ExecQueryAsync et définissent cette propriété sur une ou plusieurs des valeurs suivantes (le type de propriété est un tableau).
"WQL:UnarySelect"
"WQL:References"
"WQL:Associators"
"WQL:V1ProviderDefined"
SupportsBatching
-
Type de données : booléen
-
Type d’accès : lecture/écriture
Non utilisé.
SupportsDelete
-
Type de données : booléen
-
Type d’accès : lecture/écriture
Si la valeur est True, le fournisseur prend en charge la suppression des données.
Vrai
Le fournisseur prend en charge la suppression de classes ou d’instances en implémentant IWbemServices::DeleteClassAsync (fournisseurs de classes) ou IWbemServices::DeleteInstanceAsync (fournisseurs d’instances).
Faux
Le fournisseur ne prend pas en charge la suppression des données et retourne WBEM_E_PROVIDER_NOT_CAPABLE à partir de DeleteClassAsync ou DeleteInstanceAsync.
SupportsEnumeration
-
Type de données : booléen
-
Type d’accès : lecture/écriture
Si la valeur est True, le fournisseur prend en charge l’énumération des données.
Vrai
Le fournisseur prend en charge l’énumération des données en implémentant IWbemServices::CreateClassEnumAsync (fournisseurs de classes) ou IWbemServices::CreateInstanceEnumAsync (fournisseurs d’instances).
Faux
Le fournisseur ne prend pas en charge l’énumération des données et retourne WBEM_E_PROVIDER_NOT_CAPABLE à partir de CreateClassEnumAsync ou CreateInstanceEnumAsync.
SupportsGet
-
Type de données : booléen
-
Type d’accès : lecture/écriture
Si la valeur est True, le fournisseur de classes ou instances prend en charge l’extraction de données.
Vrai
Le fournisseur prend en charge l’extraction des données en implémentant IWbemServices::GetObjectAsync.
Faux
Le fournisseur ne prend pas en charge l’extraction des données et retourne WBEM_E_PROVIDER_NOT_CAPABLE à partir de GetObjectAsync.
SupportsPut
-
Type de données : booléen
-
Type d’accès : lecture/écriture
Si la valeur est True, le fournisseur de classes ou instances prend en charge la modification des données.
Vrai
Le fournisseur prend en charge la modification de classes ou d’instances en implémentant IWbemServices::PutClassAsync (fournisseurs de classes) ou IWbemServices::PutInstanceAsync (fournisseurs de classes).
Faux
Le fournisseur ne prend pas en charge la modification des données et retourne WBEM_E_PROVIDER_NOT_CAPABLE à partir de PutClassAsync ou PutInstanceAsync.
SupportsTransactions
-
Type de données : booléen
-
Type d’accès : lecture/écriture
Non utilisé.
Notes
La classe __ObjectProviderRegistration est dérivée de __ProviderRegistration.
Les fournisseurs de classes doivent définir la propriété SupportsEnumeration sur True, car les fournisseurs doivent être en mesure de fournir à WMI une liste de leurs classes. Si un fournisseur de classes tente de définir cette propriété sur False, WMI signale l’inscription comme illégale. Les fournisseurs d’instances ne sont pas requis pour prendre en charge l’énumération et peuvent choisir de définir SupportsEnumeration sur True ou False.
Un fournisseur qui définit QuerySupportLevels sur « WQL:UnarySelect » peut accepter une requête qui se compose de l’instruction SELECT de base telle que prise en charge dans WMI version 1.0. Les fournisseurs de classes et instances sont censés être en mesure de gérer la propriété système __CLASS. Les fournisseurs de classes sont également censés traiter la propriété système __SUPERCLASS et l’opérateur ISA. L’opérateur ISA est utilisé pour développer un jeu de résultats en classes dérivées. Si un fournisseur reçoit une requête qu’il ne peut pas interpréter, il demande à WMI de la gérer en retournant la valeur d’erreur WBEM_E_TOO_COMPLEX. Pour obtenir une description de la syntaxe WQL valide, consultez Interrogation avec WQL.
Un fournisseur qui définit QuerySupportLevels sur WQL:V1ProviderDefined peut essayer de prendre en charge un ensemble plus grand de la syntaxe SQL à ses propres risques, comme la clause ORDER BY
. WMI n’interprète pas les clauses supplémentaires et ne tente pas de s’assurer que le jeu de résultats est correct.
Seuls les administrateurs peuvent inscrire ou supprimer un fournisseur en créant une instance de __Win32Provider et en l’inscrivant.
Spécifications
Condition requise | Valeur |
---|---|
Client minimal pris en charge |
Windows Vista |
Serveur minimal pris en charge |
Windows Server 2008 |
Espace de noms |
Tous les espaces de noms WMI |