Méthode TakeOwnerShip de la classe Win32_Directory

Article
06/12/2023

La méthode de classe WMITakeOwnerShip obtient la propriété du fichier logique spécifié dans le chemin d’accès de l’objet. Si le fichier logique est en fait un répertoire, TakeOwnerShip agit de manière récursive, en prenant possession de tous les fichiers et sous-répertoires que contient le répertoire.

Cette rubrique utilise la syntaxe MOF (Managed Object Format). Pour plus d’informations sur l’utilisation de cette méthode, consultez Appel d’une méthode.

Syntaxe

uint32 TakeOwnerShip();

Paramètres

Cette méthode n’a aucun paramètre.

Valeur retournée

Retourne l’une des valeurs suivantes.

0: La demande a abouti.
2: L’accès a été refusé.
8: Un échec non spécifié s’est produit.
9: Le nom spécifié n’était pas valide.
10: L’objet spécifié existe déjà.
11: Le système de fichiers n’est pas NTFS.
12: La plateforme n’est pas Windows.
13: Le lecteur n’est pas le même.
14: Le répertoire n'est pas vide.
15: Il y a eu une violation du partage.
16: Le fichier de démarrage spécifié n’était pas valide.
17: Un privilège requis pour l’opération n’est pas conservé.
21: Un paramètre spécifié n’est pas valide.

Exemples

Le code de script Visual Basic suivant appelle la méthode TakeOwnerShip pour prendre possession du dossier C:\temp.

strComputer = "." 

Set objWMIService = _
    GetObject("winmgmts:\\" & strComputer & "\root\CIMV2") 

' Obtain the definition of the class.
Set objShare = objWMIService.Get("Win32_Directory")

' Execute the method and obtain the return status.
' The OutParameters object in objOutParams
' is created by the provider.
Set objOutParams = objWMIService.ExecMethod( _
    "Win32_Directory.Name='C:\\temp'", "TakeOwnerShip")

wscript.echo objOutParams.ReturnValue

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

Classes du système d’exploitation
Win32_Directory