__Win32Provider, classe

La classe système _ _ Win32Provider inscrit des informations sur l’implémentation physique d’un fournisseur dans WMI. Les fournisseurs qui ne définissent pas la propriété HostingModel sont chargés, par défaut, pour s’exécuter dans un processus Wmiprvse.exe en tant que NetworkServiceHostOrSelfHost.

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 par ordre alphabétique, et non par ordre MOF.

Syntaxe

class __Win32Provider : __Provider
{
  string   ClientLoadableCLSID;
  string   CLSID;
  sint32   Concurrency;
  string   DefaultMachineName;
  boolean  Enabled;
  string   HostingModel;
  sint32   ImpersonationLevel = 0;
  sint32   InitializationReentrancy;
  datetime InitializationTimeoutInterval;
  boolean  InitializeAsAdminFirst;
  string   Name;
  datetime OperationTimeoutInterval;
  boolean  PerLocaleInitialization = FALSE;
  boolean  PerUserInitialization = FALSE;
  boolean  Pure = TRUE;
  string   SecurityDescriptor;
  boolean  SupportsExplicitShutdown;
  boolean  SupportsExtendedStatus;
  boolean  SupportsQuotas;
  boolean  SupportsSendStatus;
  boolean  SupportsShutdown;
  boolean  SupportsThrottling;
  datetime UnloadTimeout;
  uint32   Version;
};

Membres

La classe _ _ Win32Provider possède les types de membres suivants :

Propriétés

La classe _ _ Win32Provider possède les propriétés suivantes.

ClientLoadableCLSID

Type de données : chaîne

Type d’accès : lecture/écriture

Identificateur de classe utilisé par WMI pour déterminer s’il faut charger un fournisseur de haute performance dans le processus client ou le processus WMI. Si le fournisseur et le client se trouvent sur le même ordinateur, WMI charge le fournisseur in-process sur le client en utilisant ClientLoadableCLSID comme identificateur de classe. Lorsque le fournisseur et le client se trouvent sur des ordinateurs différents, WMI charge le fournisseur in-process dans le processus WMI. WMI utilise également ClientLoadableCLSID pour prendre en charge les opérations d’actualisation.

Pour plus d’informations, consultez inscription d’un fournisseur de High-Performance.

IDENTIFICATEUR

Type de données : chaîne

Type d’accès : lecture/écriture

GUID qui représente l’identificateur de classe (CLSID) de l’objet com du fournisseur. Cet objet COM doit contenir une implémentation de l’interface IWbemProviderInit .

Concurrency

Type de données : sint32

Type d’accès : lecture/écriture

Non utilisé.

DefaultMachineName

Type de données : chaîne

Type d’accès : lecture/écriture

Identifie l’ordinateur sur lequel démarrer le fournisseur. Si le fournisseur s’exécute sur l’ordinateur local, il a la valeur null.

Activé

Type de données : booléen

Type d’accès : lecture/écriture

Si la valeur est true, cette instance est activée et peut être utilisée pour effectuer les demandes des clients.

HostingModel

Type de données : chaîne

Type d’accès : lecture/écriture

Cette propriété est composée de valeurs des propriétés HostingGroup et HostingSpecification des _ fournisseurs msft . La valeur de cette propriété spécifie comment WMI charge le fournisseur et le compte de sécurité sous lequel il s’exécute. Pour plus d’informations sur la définition de la propriété HostingModel , consultez hébergement et sécurité du fournisseur et inscription d’un fournisseur.

ImpersonationLevel

Type de données : sint32

Type d’accès : lecture/écriture

Réservé. La valeur par défaut est zéro (0).

InitializationReentrancy

Type de données : sint32

Type d’accès : lecture/écriture

Jeu d’indicateurs qui fournissent des informations sur la sérialisation. La valeur par défaut est zéro (0).

0

Toute l’initialisation de ce fournisseur doit être sérialisée.

1

Toutes les initialisations de ce fournisseur dans le même espace de noms doivent être sérialisées.

2

Aucune sérialisation d’initialisation n’est nécessaire.

InitializationTimeoutInterval

Type de données : DateTime

Type d’accès : lecture/écriture

Non utilisé.

InitializeAsAdminFirst

Type de données : booléen

Type d’accès : lecture/écriture

TBD

Nom

Type de données : chaîne

Type d’accès : lecture/écriture

Qualificateurs : clé

Nom du fournisseur.

OperationTimeoutInterval

Type de données : DateTime

Type d’accès : lecture/écriture

Non utilisé.

PerLocaleInitialization

Type de données : booléen

Type d’accès : lecture/écriture

Si la valeur est true, le fournisseur est initialisé pour chaque paramètre régional lorsqu’un utilisateur se connecte à un même espace de noms plusieurs fois à l’aide de différents paramètres régionaux. La valeur par défaut est FALSE.

PerUserInitialization

Type de données : booléen

Type d’accès : lecture/écriture

Si la valeur est true, le fournisseur est initialisé une fois pour chaque utilisateur NT LAN Manager (NTLM) qui effectue des demandes au fournisseur. Si la valeur est false (valeur par défaut), le fournisseur est initialisé une fois pour tous les utilisateurs.

FCP

Type de données : booléen

Type d’accès : lecture/écriture

Si la valeur est true, le fournisseur s’engage à préparer le déchargement en appelant IUnknown :: Release sur tous les points d’interface en attente lorsque WMI appelle la méthode de mise en version de son interface principale. Les fournisseurs qui doivent conserver les clients de WMI après qu’ils ne fonctionnent pas comme les fournisseurs doivent définir pure sur false. Le paramètre par défaut est true. Pour plus d’informations, consultez la section Notes de cette rubrique.

SecurityDescriptor

Type de données : chaîne

Type d’accès : lecture/écriture

Le descripteur de sécurité (SD) dans le langage SDDL (Security Descriptor Definition Language) qui détermine l’ensemble des utilisateurs qui peuvent appeler IWbemDecoupledRegistrar : Register pour le fournisseur découplé. pour plus d’informations, consultez la rubrique langage de définition du descripteur de sécurité dans la section sécurité de la SDK Windows. Ce descripteur de sécurité est utilisé uniquement pour les fournisseurs découplés et n’affecte pas les autres fournisseurs. Pour plus d’informations, consultez incorporation d’un fournisseur dans une application.

WMI effectue des vérifications d’accès pour les fournisseurs découplés qui utilisent les interfaces IWbemProviderInit et IWbemObjectSink . Si le descripteur de sécurité a la valeur null, seules les applications ou les services qui s’exécutent sous les comptes LocalSystem, NetworkService et LocalService peuvent exécuter un fournisseur découplé.

La chaîne suivante montre un fournisseur découplé qui doit être exécuté uniquement par des administrateurs intégrés.» O :BAG : BAD : (A ;; 0 x1 ;;; BA)»

Pour plus d’informations sur la définition de la propriété SecurityDescriptor , consultez maintenance de la sécurité WMI.

SupportsExplicitShutdown

Type de données : booléen

Type d’accès : lecture/écriture

Non utilisé.

SupportsExtendedStatus

Type de données : booléen

Type d’accès : lecture/écriture

Non utilisé.

SupportsQuotas

Type de données : booléen

Type d’accès : lecture/écriture

Non utilisé.

SupportsSendStatus

Type de données : booléen

Type d’accès : lecture/écriture

Non utilisé.

SupportsShutdown

Type de données : booléen

Type d’accès : lecture/écriture

Non utilisé.

SupportsThrottling

Type de données : booléen

Type d’accès : lecture/écriture

Non utilisé.

UnloadTimeout

Type de données : DateTime

Type d’accès : lecture/écriture

Format de date et d’heure qui spécifie la durée pendant laquelle WMI autorise le fournisseur à rester inactif avant d’être déchargé. En règle générale, les fournisseurs demandent que WMI n’attende pas plus de cinq minutes.

Pour la version actuelle de WMI, la valeur de cette propriété est ignorée. WMI décharge le fournisseur en fonction de la valeur du délai d’attente dans une classe interne de l' \ espace de noms racine. Il est recommandé que les fournisseurs définissent UnloadTimeout. Pour plus d’informations, consultez déchargement d’un fournisseur.

Version

Type de données : UInt32

Type d’accès : lecture/écriture

Version du fournisseur. Les versions prises en charge sont 1 et 2. La version 2 renforce les contrôles de validité de toutes les inscriptions de propriété associées, en particulier la propriété ImpersonationLevel .

Remarques

La classe _ _ Win32Provider est dérivée du _ _ fournisseur.

La plupart des fournisseurs peuvent accepter les valeurs par défaut de la propriété InitializationReentrancy . Toutefois, si un fournisseur peut prendre en charge l’initialisation simultanée pour des utilisateurs distincts, cette propriété peut avoir la valeur 1 (un). Si l’initialisation sérialisée est nécessaire, InitializationReentrancy reste 0 (zéro). Dans les deux instances, PerUserInitialization a la valeur true.

Un fournisseur pur ou un fournisseur qui affecte à la propriété pure la valeur true, existe uniquement pour les demandes de service d’applications et WMI. La plupart des fournisseurs sont des fournisseurs purs. Un fournisseur non pur est l’exception. Les fournisseurs non purs effectuent la transition vers le rôle du client une fois qu’ils ont terminé de traiter les demandes.

Un fournisseur d’émission qui commence à émettre des requêtes et effectue des demandes de WMI une fois l’initialisation terminée est un exemple de fournisseur non pur. Un fournisseur de notifications push n’a pas de responsabilités, sauf pour mettre à jour le référentiel CIM avec des données au moment de l’initialisation. Après la mise à jour du référentiel, un fournisseur d’émission peut attendre le déchargement ou la transition vers le rôle de client. Le fournisseur push qui attend le déchargement est un fournisseur pur. Le fournisseur push qui participe aux activités des clients est non pur.

WMI doit être en mesure de distinguer les fournisseurs purs des fournisseurs non purs afin qu’il puisse déterminer quand il est possible de s’arrêter en toute sécurité. WMI doit attendre la fin de toutes les opérations qui impliquent des fournisseurs non purs avant de pouvoir s’arrêter en toute sécurité.

Configuration requise

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

__Fournisseur

Classes système WMI

Inscription d’un fournisseur