Een kwalificatie toepassen

Net als bij veel andere technieken in Managed Object Format (MOF) is het toepassen van een kwalificatie op uw code een relatief eenvoudig proces.

De enige echte uitdagingen zijn de volgende beperkingen in naamconventies die WMI afdwingt:

• Een kwalificatie kan een klasse, instantie, eigenschap, methode of methodeparameter beschrijven.

• Kwalificatienamen mogen geen onderstrepingstekens aan het begin of einde hebben.

• Een kwalificatienaam kan niet beginnen met een cijfer.

• Een kwalificatienaam mag geen speciale tekens bevatten, zoals & * @ ! ~ \ /.

• Alle kwalificatienamen zijn hoofdletterongevoelig.

• U kunt de standaard WMI-kwalificaties of eventuele kwalificaties die in de DMTF CIM-specificatie worden beschreven, niet opnieuw definiëren.

• Kwalificatietypen worden niet expliciet gedeclareerd.

  Als u geen kwalificatietype declareert, wordt door WMI uitgegaan van het type als Booleaanse waarde met een waarde van TRUE. Anders typen WMI kwalificaties op basis van de kwalificatiewaarden die u declareert.

• Wanneer u uw eigen kwalificaties maakt, moet u de schemanaam vooraf laten gaan aan uw kwalificatienaam.

  Het doel van deze regel is om verwarring met nieuwe kwalificaties te voorkomen.

• U kunt homogene matrices van kwalificaties maken.

  In het volgende codevoorbeeld ziet u hoe kwalificatiematrices worden opgegeven met accolades die de waarden omsluiten.

  [StringArray{"hello", "there"}, SingleElementArray{3}]
  

• WMI biedt geen ondersteuning voor automatiseringstypen die niet worden vermeld in de verwijzing, zoals VT_NULL. Zie MOF-gegevenstypenvoor meer informatie.

Met de volgende procedure kunt u C++ gebruiken om een kwalificatie toe te voegen aan een eigenschap.

Een kwalificatie toepassen met behulp van C++

• Pas de kwalificatie toe met een aanroep naar de methode IWbemQualifierSet::P ut.

  U kunt andere methoden van IWbemQualifierSet gebruiken om bestaande kwalificaties op te halen of te verwijderen.

Met de volgende procedure kunt u een kwalificatie toepassen in MOF-bestanden.

Een trefwoord of id met een kwalificatie beschrijven met behulp van MOF-

• Plaats een kwalificatie tussen haakjes vóór het trefwoord of de id die wordt beschreven door de kwalificatie.

  In het volgende codevoorbeeld ziet u hoe kwalificaties worden gebruikt.

  [qualifiers...]
  class StdDisk
  {
    [qualifiers...]  uint32 dwNumCylinders;
    [qualifiers...]  uint32 dwNumHeads;
    [qualifiers...]  sint32 Method1();
    sint32 Method2([qualifiers...] Parameter1);
  };
  

  In het volgende voorbeeld wordt de juiste plaatsing van kwalificatoren beschreven.

  [Abstract]
  class MyClass
  {
      [Amendment, InstanceOf]  uint32 dwNumber;
      sint32 MyMethod ([in] sint32 Param);
  };