classe Win32_CodecFile

La classe WMI Win32_CodecFile représente le codec audio ou vidéo installé sur le système informatique. Les codecs convertissent un type de format multimédia en un autre, généralement un format compressé en format non compressé. Le nom « codec » est dérivé d’une combinaison de compresser et décompresser. Par exemple, un codec peut convertir un format compressé, tel que MS-ADPCM, en un format non compressé tel que PCM, que la plupart du matériel audio peut lire directement.

La syntaxe suivante est simplifiée par rapport au code 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

[Dynamic, Provider("CIMWin32"), UUID("{8502C4C3-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_CodecFile : CIM_DataFile
{
  uint32   AccessMask;
  boolean  Archive;
  string   Caption;
  boolean  Compressed;
  string   CompressionMethod;
  string   CreationClassName;
  datetime CreationDate;
  string   CSCreationClassName;
  string   CSName;
  string   Description;
  string   Drive;
  string   EightDotThreeFileName;
  boolean  Encrypted;
  string   EncryptionMethod;
  string   Extension;
  string   FileName;
  uint64   FileSize;
  string   FileType;
  string   FSCreationClassName;
  string   FSName;
  string   Group;
  boolean  Hidden;
  datetime InstallDate;
  uint64   InUseCount;
  datetime LastAccessed;
  datetime LastModified;
  string   Manufacturer;
  string   Name;
  string   Path;
  boolean  Readable;
  string   Status;
  boolean  System;
  string   Version;
  boolean  Writeable;
};

Membres

La classe Win32_CodecFile a les types de membres suivants :

• Méthodes
• Propriétés

Méthodes

La classe Win32_CodecFile a ces méthodes.

Méthode	Description
ChangeSecurityPermissions	Modifie les autorisations de sécurité pour le fichier logique spécifié dans le chemin d’accès de l’objet.
ChangeSecurityPermissionsEx	Modifie les autorisations de sécurité pour le fichier logique spécifié dans le chemin d’accès de l’objet.
Compresser	Compresse le fichier logique (ou répertoire) spécifié dans le chemin d’accès de l’objet.
CompressEx	Compresse le fichier logique (ou répertoire) spécifié dans le chemin d’accès de l’objet.
Copier	Copie le fichier logique ou le répertoire spécifié dans le chemin d’accès de l’objet à l’emplacement spécifié par le paramètre d’entrée.
CopyEx	Méthode de classe qui copie le fichier logique ou le répertoire spécifié dans le chemin d’accès de l’objet à l’emplacement spécifié par le paramètre FileName.
Supprimer	Supprime le fichier logique (ou répertoire) spécifié dans le chemin d’accès de l’objet.
DeleteEx	Supprime le fichier logique (ou répertoire) spécifié dans le chemin d’accès de l’objet.
GetEffectivePermission	Détermine si l’appelant dispose des autorisations agrégées spécifiées par l’argument d’autorisation non seulement sur l’objet fichier, mais aussi sur le partage sur lequel réside le fichier ou le répertoire (s’il se trouve sur un partage).
Renommer	Méthode de classe qui renomme le fichier logique (ou répertoire) spécifié dans le chemin d’accès de l’objet.
TakeOwnerShip	Obtient la propriété du fichier logique spécifié dans le chemin d’accès de l’objet.
TakeOwnerShipEx	Méthode de classe qui obtient la propriété du fichier logique spécifié dans le chemin d’accès de l’objet.
Décompresser	Annule la copie du fichier logique (ou répertoire) spécifié dans le chemin d’accès de l’objet.
UncompressEx	Annule la copie du fichier logique (ou répertoire) spécifié dans le chemin d’accès de l’objet.

Propriétés

La classe Win32_CodecFile possède ces propriétés.

AccessMask

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »), DisplayName (« Droits d’accès »)

Masque de bits qui représente les droits d’accès nécessaires pour accéder au fichier codec ou effectuer des opérations spécifiques. Pour les valeurs de bits, consultez Constantes des droits d’accès aux fichiers et aux répertoires.

Notes

Sur les volumes FAT, la valeur FULL_ACCESS est retournée à la place, ce qui indique qu’aucune sécurité n’a été définie sur l’objet.

Cette propriété est héritée de CIM_LogicalFile.

FILE_READ_DATA (fichier) ou FILE_LIST_DIRECTORY (répertoire) (1)

FILE_WRITE_DATA (fichier) ou FILE_ADD_FILE (répertoire) (2)

FILE_APPEND_DATA (fichier) ou FILE_ADD_SUBDIRECTORY (répertoire) (4)

FILE_READ_EA (8)

FILE_WRITE_EA (16)

FILE_EXECUTE (fichier) ou FILE_TRAVERSE (répertoire) (32)

FILE_DELETE_CHILD (répertoire) (64)

FILE_READ_ATTRIBUTES (128)

FILE_WRITE_ATTRIBUTES (256)

DELETE (65536)

READ_CONTROL (131072)

WRITE_DAC (262144)

WRITE_OWNER (524288)

SYNCHRONIZE (1048576)

Archive

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »), DisplayName (« Doit être archivé »)

Si la valeur est True, le fichier doit être archivé.

Cette propriété est héritée de CIM_LogicalFile.

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64), DisplayName (« Caption »)

Brève description de l’objet.

Cette propriété est héritée de CIM_ManagedSystemElement.

Compressed

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »), DisplayName (« compressé »)

Si la valeur est True, le fichier est compressé.

Cette propriété est héritée de CIM_LogicalFile.

CompressionMethod

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Compression Method »)

Algorithme ou outil utilisé pour compresser le fichier logique. S’il n’est pas possible (ou non souhaité) de décrire le schéma de compression (peut-être parce qu’il n’est pas connu), utilisez les mots suivants : « Inconnu » pour indiquer qu’il n’est pas connu si le fichier logique est compressé ou non ; « Compressé » pour représenter que le fichier est compressé, mais que son schéma de compression n’est pas connu ou n’est pas divulgué ; et « Non compressé » pour représenter que le fichier logique n’est pas compressé.

Cette propriété est héritée de CIM_LogicalFile.

CreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : CIM_Key, DisplayName (« Nom de la classe »)

Nom de la première classe concrète à apparaître dans la chaîne d’héritage utilisée dans la création d’un instance. Lorsqu’elle est utilisée avec les autres propriétés clés de la classe, la propriété permet à toutes les instances de cette classe et de ses sous-classes d’être identifiées de manière unique.

Cette propriété est héritée de CIM_LogicalFile.

CreationDate

Type de données : datetime

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Date de création »)

Date de création du fichier.

Cette propriété est héritée de CIM_LogicalFile.

CSCreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : propagé (« CIM_FileSystem. CSCreationClassName »), CIM_Key, DisplayName (« Nom de la classe système de l’ordinateur »)

Classe du système informatique.

Cette propriété est héritée de CIM_LogicalFile.

CSName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : propagé (« CIM_FileSystem. CSName »), CIM_Key, DisplayName (« Nom du système d’ordinateur »)

Chaîne représentant le nom du système informatique.

Cette propriété est héritée de CIM_LogicalFile.

Description

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Remplacer (Description), MappingStrings (« Win32Registry| System\\CurrentControlSet\\control\\MediaResources\\icm|Description »)

Nom complet du pilote de codec. Cette chaîne est destinée à être affichée dans de grands espaces (descriptifs).

Cette propriété est héritée de CIM_ManagedSystemElement.

Exemple : « Microsoft PCM Converter »

Disque

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Fixe, Schéma (« Win32 »), DisplayName (« Lecteur »)

Lettre de lecteur (y compris les deux-points) du fichier.

Cette propriété est héritée de CIM_LogicalFile.

Exemple : « c: »

EightDotThreeFileName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »), DisplayName (« Nom de fichier à huit points trois »)

Nom de fichier compatible DOS pour ce fichier.

Cette propriété est héritée de CIM_LogicalFile.

Exemple : « c:\progra~1 »

Chiffré

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »), DisplayName (« Chiffré »)

Si la valeur est True, le fichier est chiffré.

Cette propriété est héritée de CIM_LogicalFile.

EncryptionMethod

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Méthode de chiffrement »)

Algorithme ou outil utilisé pour chiffrer le fichier logique. S’il n’est pas possible (ou non souhaité) de décrire le schéma de chiffrement (peut-être pour des raisons de sécurité), utilisez les mots suivants : « Inconnu » pour indiquer qu’il n’est pas connu si le fichier logique est chiffré ou non ; « Chiffré » pour représenter que le fichier est chiffré, mais que son schéma de chiffrement n’est pas connu ou n’est pas divulgué ; et « Non chiffré » pour représenter que le fichier logique n’est pas chiffré.

Cette propriété est héritée de CIM_LogicalFile.

Extension

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Fixed, Schema (« Win32 »), DisplayName (« File Extension »)

Extension de nom de fichier (sans point).

Cette propriété est héritée de CIM_LogicalFile.

Exemples : « txt », « mof », « mdb »

FileName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Fixe, Schéma (« Win32 »), DisplayName (« Nom de fichier »)

Nom (sans l’extension) du fichier.

Cette propriété est héritée de CIM_LogicalFile.

Exemple : « autoexec »

FileSize

Type de données : uint64

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Taille »), Unités (« octets »)

Taille du fichier (en octets).

Cette propriété est héritée de CIM_LogicalFile.

Pour plus d’informations sur l’utilisation de valeurs uint64 dans des scripts, voir Scripts dans WMI.

FileType

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »), DisplayName (« Type de fichier »)

Type de fichier (indiqué par la propriété Extension ).

Cette propriété est héritée de CIM_LogicalFile.

FSCreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : propagé (« CIM_FileSystem. CreationClassName « ), CIM_Key, DisplayName (« Nom de classe du système de fichiers »)

Classe du système de fichiers.

Cette propriété est héritée de CIM_LogicalFile.

FSName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : propagé (« CIM_FileSystem. Nom »), CIM_Key, DisplayName (« Nom du système de fichiers »)

Nom du système de fichiers.

Cette propriété est héritée de CIM_LogicalFile.

Groupe

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« Win32Registry| SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\drivers.desc »)

Codec représenté par cette classe.

Les valeurs sont :

« Audio »

« Vidéo »

Audio (« Audio »)

Vidéo (« Vidéo »)

Hidden

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »), DisplayName (« Masqué »)

Si la valeur est True, le fichier est masqué.

Cette propriété est héritée de CIM_LogicalFile.

InstallDate

Type de données : datetime

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIF. DMTF| ComponentID|001.5 »), DisplayName (« Date d’installation »)

L’objet a été installé. Cette propriété ne nécessite pas de valeur pour indiquer que l’objet est installé.

Cette propriété est héritée de CIM_ManagedSystemElement.

InUseCount

Type de données : uint64

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« nombre d’ouvertures de fichier actuel »)

Nombre d'« ouvertures de fichier » actuellement actives sur le fichier.

Cette propriété est héritée de CIM_LogicalFile.

Pour plus d’informations sur l’utilisation de valeurs uint64 dans des scripts, voir Scripts dans WMI.

LastAccessed

Type de données : datetime

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Dernier accès »)

Le fichier a été consulté pour la dernière fois.

Cette propriété est héritée de CIM_LogicalFile.

LastModified

Type de données : datetime

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Dernière modification »)

Le fichier a été modifié pour la dernière fois.

Cette propriété est héritée de CIM_LogicalFile.

Fabricant

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Schema (« Win32 »), DisplayName (« Manufacturer »)

Chaîne de fabricant de la ressource de version, le cas échéant.

Cette propriété est héritée de CIM_DataFile.

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Clé

Nom hérité qui sert de clé d’un fichier logique instance dans un système de fichiers. Les noms de chemin d’accès complets doivent être fournis.

Cette propriété est héritée de CIM_ManagedSystemElement.

Exemple : « C:\Windows\system\win.ini »

Chemin d’accès

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Fixe, Schéma (« Win32 »), DisplayName (« Chemin »)

Chemin du fichier. Cela inclut les barres obliques inverses de début et de fin.

Cette propriété est héritée de CIM_LogicalFile.

Exemple : « \windows\system\ »

Lisible

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« lisible »)

Le fichier peut être lu.

Cette propriété est héritée de CIM_LogicalFile.

État

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (10), DisplayName (« Status »)

Status actuelle de l’objet. Différents états opérationnels et non opérationnels peuvent être définis. Les états opérationnels incluent : « OK », « Détérioré » et « Échec anticipé » (un élément, tel qu’un lecteur de disque dur smart, peut fonctionner correctement, mais prédire une défaillance dans un avenir proche). Les états non coopératifs incluent : « Erreur », « Démarrage », « Arrêt » et « Service ». Ce dernier, « Service », peut s’appliquer lors de la miroir-resilver d’un disque, du rechargement d’une liste d’autorisations utilisateur ou d’autres tâches administratives. Tous ces travaux ne sont pas en ligne, mais l’élément managé n’est ni « OK », ni dans l’un des autres états.

Cette propriété est héritée de CIM_ManagedSystemElement.

Les valeurs sont notamment les suivantes :

OK (« OK »)

Erreur (« Erreur »)

Détérioré (« Détérioré »)

Inconnu (« Inconnu »)

Échec de la préversion (« Échec prédé »)

Démarrage (« Démarrage »)

Arrêt (« Arrêt »)

Service (« Service »)

Stressé (« Stressé »)

NonRecover (« NonRecover »)

Aucun contact (« Aucun contact »)

Lost Comm (« Lost Comm »)

Système

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »), DisplayName (« Fichier système »)

Si la valeur est True, le fichier est un fichier système.

Cette propriété est héritée de CIM_LogicalFile.

Version

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Schema (« Win32 »), DisplayName (« Version »)

Chaîne de version de la ressource version, le cas échéant.

Cette propriété est héritée de CIM_DataFile.

Inscriptible

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Accessible en écriture »)

Si la valeur est True, le fichier peut être écrit.

Cette propriété est héritée de CIM_LogicalFile.

Notes

La classe Win32_CodecFile est dérivée de CIM_DataFile.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Espace de noms	Racine\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Voir aussi

CIM_DataFile

Classes du système d’exploitation