IUpdateServiceManager::RegisterServiceWithAU メソッド (wuapi.h)

  • [アーティクル]

自動更新にサービスを登録します。

構文

HRESULT RegisterServiceWithAU(
  [in] BSTR serviceID
);

パラメーター

[in] serviceID

登録するサービスの識別子。

戻り値

成功した場合 はS_OK を返します。 それ以外の場合は、COM または Windows のエラー コードを返します。

このメソッドは、次のエラー コードを返すこともできます。

リターン コード 説明
E_INVALIDARG
パラメーター値が無効です。
E_ACCESSDENIED
 リモート コンピューターからこのメソッドを呼び出すことはできません。
WU_E_DS_UNKNOWNSERVICE
 不明なサービスを登録しようとしました。
WU_E_DS_NEEDWINDOWSSERVICE
 Windows Update サービスを削除できませんでした。
WU_E_INVALID_OPERATION
 コンピューターが更新サイトにアクセスできなかったか、自動更新の状態を変更できませんでした。

注釈

登録するサービスが自動更新に不明な場合、このメソッドはWU_E_DS_UNKNOWNSERVICEを返します。

メソッドが無効なサービス ID で呼び出された場合、このメソッドは WU_E_INVALID_OPERATION を返します。 このメソッドは、サービス ID が有効であるが、サービスが自動更新に登録できない場合にもWU_E_INVALID_OPERATIONを返します。 つまり、自動更新の状態の要求された変更は、承認キャビネット ファイルの仕様に反します (たとえば、CanRegisterWithAU プロパティは FALSE に設定されています)。 承認キャビネット ファイルが署名されていない場合、 WinVerifyTrust 関数によってエラーが返されます。

Windows Update サービスを削除しようとすると、このメソッドはWU_E_DS_NEEDWINDOWSSERVICEを返します。

要件

要件 値
サポートされている最小のクライアント Windows XP、Windows 2000 Professional SP3 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003、Windows 2000 Server SP3 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wuapi.h
Library Wuguid.lib
[DLL] Wuapi.dll

こちらもご覧ください

IUpdateServiceManager