Método IUpdateServiceManager::AddScanPackageService (wuapi.h)
Registra um pacote de verificação como um serviço com o WUA (agente de Windows Update) e retorna uma interface IUpdateService.
Sintaxe
HRESULT AddScanPackageService(
[in] BSTR serviceName,
[in] BSTR scanFileLocation,
[in] LONG flags,
[out] IUpdateService **ppService
);
Parâmetros
[in] serviceName
Um nome descritivo para o serviço de pacote de verificação.
[in] scanFileLocation
O caminho do arquivo de verificação assinado pela Microsoft que precisa ser registrado como um serviço.
[in] flags
Determina como remover o registro de serviço do pacote de verificação.
Para obter valores possíveis, consulte UpdateServiceOption.
[out] ppService
Um ponteiro para uma interface IUpdateService que contém informações de registro de serviço.
Retornar valor
Retorna S_OK se tiver êxito. Caso contrário, retornará um código de erro COM ou Windows. Esse método também pode retornar os seguintes códigos de erro.
| Código de retorno | Descrição |
|---|---|
|
Um valor de parâmetro é inválido. |
|
Esse método não pode ser chamado de um computador remoto. |
|
O computador não pôde acessar o site de atualização. |
Comentários
Você pode usar a ID do serviço em pesquisas passando a ID como a propriedade ServiceID da interface IUpdateSearcher .
Para liberar recursos, remova o serviço depois que ele não for mais necessário. Use o método RemoveService para remover o serviço.
Não chame o método RegisterServiceWithAU para o serviço que o método AddScanPackageService registra.
O serviço retornado por AddScanPackageService está na coleção de serviços que a propriedade Services da interface IUpdateServiceManager retorna. Esse serviço tem a propriedade especial IsScanPackageService .
Um erro será retornado por WinVerifyTrust se a Cab de Autorização não estiver assinada.
Esse método retornará WU_E_INVALID_OPERATION se o objeto que implementa a interface tiver sido bloqueado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP, Windows 2000 Professional com SP3 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003, Windows 2000 Server com SP3 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | wuapi.h |
| Biblioteca | Wuguid.lib |
| DLL | Wuapi.dll |