SWbemServices. DeleteAsync, méthode
La méthode DeleteAsync de l’objet SWbemServices supprime la classe ou l’instance spécifiée dans le chemin d’accès de l’objet. L’appel à DeleteAsync retourne immédiatement et les résultats et l’État sont retournés à l’appelant via des événements remis au récepteur spécifié dans objWbemSink. Pour plus d’informations sur la création d’un récepteur, consultez réception d’un événement WMI. Vous ne pouvez supprimer que les objets de l’espace de noms auquel vous êtes connecté.
Si un fournisseur dynamique fournit la classe ou l’instance, il n’est pas toujours possible de supprimer cet objet, sauf si le fournisseur prend en charge la suppression de classe ou d’instance.
La méthode est appelée en mode asynchrone. Pour plus d’informations, consultez appel d’une méthode.
Pour une explication de cette syntaxe, consultez conventions de document pour l’API de script.
Syntaxe
SWbemServices.DeleteAsync( _
[ ByVal ObjWbemSink ], _
ByVal strObjectPath, _
[ ByVal iFlags ], _
[ ByVal objWbemNamedValueSet ], _
[ ByVal objWbemAsyncContext ] _
)
Paramètres
-
ObjWbemSink [ facultatif]
-
Récepteur d’objets qui reçoit les résultats de la suppression. Créez un objet SWbemSink pour recevoir les objets.
-
strObjectPath
-
Obligatoire. Chaîne qui contient le chemin d’accès à l’objet que vous souhaitez supprimer. Pour plus d’informations, consultez Description de l’emplacement d’un objet WMI.
-
IFlags [ facultatif]
-
Détermine si les mises à jour d’État sont retournées. Ce paramètre peut accepter les valeurs suivantes.
-
wbemFlagSendStatus * * * * (128 (0x80))
-
Fait en sorte que les appels asynchrones envoient des mises à jour d’État au gestionnaire d’événements OnProgress pour le récepteur d’objets.
-
wbemFlagDontSendStatus * * * * (0 (0x0))
-
Empêche les appels asynchrones d’envoyer des mises à jour d’État au gestionnaire d’événements OnProgress pour le récepteur d’objets.
objWbemNamedValueSet [ facultatif]
En général, ce n’est pas défini. Dans le cas contraire, il s’agit d’un objet SWbemNamedValueSet dont les éléments représentent les informations de contexte qui peuvent être utilisées par le fournisseur qui traite la requête. Un fournisseur qui prend en charge ou requiert ces informations doit documenter les noms de valeur reconnus, le type de données de la valeur, les valeurs autorisées et la sémantique.
objWbemAsyncContext [ facultatif]
Objet SWbemNamedValueSet qui retourne au récepteur d’objets pour identifier la source de l’appel asynchrone d’origine. Utilisez ce paramètre si vous effectuez plusieurs appels asynchrones à l’aide du même récepteur d’objets. Pour utiliser ce paramètre, créez un objet SWbemNamedValueSet et utilisez la méthode SWbemNamedValueSet. Add pour ajouter une valeur qui identifie l’appel asynchrone que vous effectuez. Cet objet SWbemNamedValueSet est retourné au récepteur d’objets et la source de l’appel peut être extraite à l’aide de la méthode SWbemNamedValueSet. Item . Pour plus d’informations, consultez appel d’une méthode.
Valeur de retour
Cette méthode ne retourne pas de valeur. Si l’appel réussit, le récepteur d’objets reçoit la notification de la suppression.
Codes d’erreur
À la fin de la méthode DeleteAsync , l’objet Err peut contenir l’un des codes d’erreur répertoriés dans la liste suivante.
-
wbemErrFailed -2147749889 (0x80041001)
-
Erreur non spécifiée.
-
wbemErrInvalidParameter -2147749896 (0x80041008)
-
Un paramètre non valide a été spécifié.
-
wbemErrOutOfMemory -2147749894 (0x80041006)
-
Mémoire insuffisante pour terminer l’opération.
-
wbemErrTransportFailure -2147749909 (0x80041015)
-
Une erreur réseau s’est produite, empêchant le fonctionnement normal.
-
wbemErrAccessDenied -2147749891 (0x80041003)
-
Le nom d’utilisateur et le mot de passe actuels ou spécifiés ne sont pas valides ou autorisés à établir la connexion.
-
wbemErrNotFound -2147749890 (0x80041002)
-
L’élément demandé est introuvable.
Remarques
Cet appel est retourné immédiatement. L’état de l’opération de suppression est retourné à l’appelant via un rappel remis au récepteur spécifié dans objWbemSink. Vous pouvez effectuer le traitement final dans votre implémentation de objWbemSink. Événement OnCompleted .
Un rappel asynchrone permet à un utilisateur non authentifié de fournir des données au récepteur. Cela pose des risques de sécurité pour vos scripts et vos applications. Pour éliminer les risques, consultez définition de la sécurité sur un appel asynchrone.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| En-tête |
|
| Bibliothèque de types |
|
| DLL |
|
| CLSID |
CLSID _ SWbemServices |
| IID |
IID _ ISWbemServices |