Classe __ObjectProviderRegistration

  • Article

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

Voir aussi

__ProviderRegistration

Classes système WMI

Inscription d’un fournisseur