IUpdateServiceManager2

更新プログラムサービスの登録を Windows Update Agent または自動更新に対して追加または削除します。(IUpdateServiceManager2)

このインターフェースのインスタンスは、UpdateServiceManager coclass を使用して作成できます。オブジェクトを作成するには、Microsoft.Update.ServiceManager プログラム識別子を使用します。

現在のクライアントアプリケーションの識別子を取得および設定します。(Get)

クライアントアプリケーションがこのプロパティを設定していない場合は、Unknown 値を返します。

現在のクライアントアプリケーションの識別子を取得および設定します。(Put)

クライアントアプリケーションがこのプロパティを設定していない場合は、Unknown 値を返します。

IUpdateServiceRegistration インターフェースへのポインターを返します。

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

承認キャビネットファイル (.cab) を必要とせずに、サービスを Windows Update Agent (WUA) に登録します。このメソッドは、IUpdateServiceRegistration インターフェースへのポインターも返します。

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

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

asfAllowOnlineRegistration フラグを指定した場合、このメソッドは ネットワークエラーコード を返すことがあります。

このメソッドでは、authorizationCabPath パラメーターは省略可能です。authorizationCabPath パラメーターを指定しない場合は、Windows Update サーバーから取得されます。

asfAllowOnlineRegistration フラグまたは asfAllowPendingRegistration フラグが指定され、かつ authorizationCabPath パラメーターの値が空の文字列でない場合、このメソッドは E_INVALIDARG を返します。

asfRegisterServiceWithAU フラグが指定されている場合に、要求された自動更新の状態変更が承認キャビネットファイル (.cab) の仕様に反しているときは、このメソッドは WU_E_DS_INVALIDOPERATION を返します。承認キャビネットファイルが署名されていない場合は、WinVerifyTrust 関数からエラーが返されます。

更新エージェントと AddService2 は、flags パラメーターに指定する AddServiceFlag 値に応じて、次のように動作します。

• asfAllowPendingRegistration を指定せずに asfAllowOnlineRegistration を指定した場合、更新エージェントは直ちにオンラインに接続してサービスの登録を試みます。AddService2 は、登録の成否を反映した HRESULT 値を返します。登録が失敗した場合、更新エージェントはそれ以降サービスの登録を試みません。
• asfAllowOnlineRegistration を指定せずに asfAllowPendingRegistration を指定した場合、更新エージェントはサービスを直ちには登録しません。AddService2 は S_OK を返し、更新エージェントが後でサービスの登録を試みることを示しますが、登録が最終的に成功することを保証するものではありません。
• asfAllowPendingRegistration と asfAllowOnlineRegistration を同時に指定した場合、更新エージェントは直ちにオンラインに接続してサービスの登録を試みます。登録が成功した場合、AddService2 は S_OK を返します。登録が失敗した場合、AddService2 は失敗を示す HRESULT 値を返しますが、更新エージェントは後でサービスの登録を試みます。
• asfAllowPendingRegistration、asfAllowOnlineRegistration、またはその両方を指定する場合は、authorizationCabPath パラメーターにも NULL を指定してください。
• asfAllowPendingRegistration と asfAllowOnlineRegistration のどちらも指定しない場合(つまり flags が 0 または asfRegisterServiceWithAU のいずれかである場合)は、authorizationCabPath パラメーターに NULL 以外のパスを指定する必要があります。このモードでは、AddService2 はキャビネットファイル (.cab) を処理し、IUpdateServiceManager::AddService と同じ方法でサービスを登録します。
• asfRegisterServiceWithAU を指定した場合、既定の自動更新サービスへの変更は、サービス登録が成功するまで行われません(また Windows Update のユーザーインターフェイスにも反映されません)。つまり、登録が(asfAllowPendingRegistration を指定したか、またはキャビネットファイル (.cab) を指定したことにより)直ちに成功した場合は、自動更新サービスの変更も直ちに行われます。登録が後になるまで成功しない場合(asfAllowPendingRegistration を指定した場合)は、保留中のサービス登録が最終的に成功しない限り、自動更新サービスの変更は行われません。