Compartilhar via


Método IUpdateServiceManager::RegisterServiceWithAU (wuapi.h)

Registra um serviço com o Atualizações Automático.

Sintaxe

HRESULT RegisterServiceWithAU(
  [in] BSTR serviceID
);

Parâmetros

[in] serviceID

Um identificador para o serviço a ser registrado.

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
E_INVALIDARG
Um valor de parâmetro é inválido.
E_ACCESSDENIED
Esse método não pode ser chamado de um computador remoto.
WU_E_DS_UNKNOWNSERVICE
Uma tentativa de registrar um serviço desconhecido.
WU_E_DS_NEEDWINDOWSSERVICE
O serviço Windows Update não pôde ser removido.
WU_E_INVALID_OPERATION
O computador não pôde acessar o site de atualização ou o estado de Atualizações automática não pôde ser alterado.

Comentários

Esse método retornará WU_E_DS_UNKNOWNSERVICE se o serviço a ser registrado for desconhecido como Atualizações automático.

Esse método retornará WU_E_INVALID_OPERATION se o método for chamado com uma ID de serviço inválida. Esse método também retornará WU_E_INVALID_OPERATION se a ID de serviço for válida, mas o serviço não puder se registrar com o Atualizações Automático. Ou seja, a alteração solicitada no estado de Atualizações Automática é contrária às especificações no arquivo de gabinete de autorização (por exemplo, a propriedade CanRegisterWithAU é definida como FALSE). Um erro será retornado pela função WinVerifyTrust se o arquivo de gabinete de autorização não tiver sido assinado.

Esse método retornará WU_E_DS_NEEDWINDOWSSERVICE se você tentar remover o serviço Windows Update.

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

Confira também

IUpdateServiceManager