Méthode IUpdateServiceManager ::AddScanPackageService (wuapi.h)

Article
08/28/2023

Inscrit un package d’analyse en tant que service avec Windows Update Agent (WUA), puis retourne une interface IUpdateService.

Syntaxe

HRESULT AddScanPackageService(
  [in]  BSTR           serviceName,
  [in]  BSTR           scanFileLocation,
  [in]  LONG           flags,
  [out] IUpdateService **ppService
);

Paramètres

[in] serviceName

Nom descriptif du service de package d’analyse.

[in] scanFileLocation

Chemin d’accès du fichier d’analyse signé Microsoft qui doit être inscrit en tant que service.

[in] flags

Détermine comment supprimer l’inscription du service du package d’analyse.

Pour connaître les valeurs possibles, consultez UpdateServiceOption.

[out] ppService

Pointeur vers une interface IUpdateService qui contient des informations d’inscription de service.

Valeur retournée

Retourne S_OK en cas de réussite. Sinon, retourne un code d’erreur COM ou Windows. Cette méthode peut également retourner les codes d’erreur suivants.

Code de retour	Description
E_INVALIDARG	Une valeur de paramètre n’est pas valide.
E_ACCESSDENIED	Cette méthode ne peut pas être appelée à partir d’un ordinateur distant.
WU_E_INVALID_OPERATION	L’ordinateur n’a pas pu accéder au site de mise à jour.

Remarques

Vous pouvez utiliser l’ID du service dans les recherches en passant l’ID comme propriété ServiceID de l’interface IUpdateSearcher .

Pour libérer des ressources, supprimez le service une fois qu’il n’est plus nécessaire. Utilisez la méthode RemoveService pour supprimer le service.

N’appelez pas la méthode RegisterServiceWithAU pour le service inscrit par la méthode AddScanPackageService .

Le service retourné par AddScanPackageService se trouve dans la collection de services que la propriété Services de l’interface IUpdateServiceManager retourne. Ce service a la propriété IsScanPackageService spéciale.

Une erreur est retournée par WinVerifyTrust si le cab d’autorisation n’est pas signé.

Cette méthode retourne WU_E_INVALID_OPERATION si l’objet qui implémente l’interface a été verrouillé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP, Windows 2000 Professionnel avec SP3 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003, Windows 2000 Server avec SP3 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wuapi.h
Bibliothèque	Wuguid.lib
DLL	Wuapi.dll

Voir aussi

IUpdateServiceManager