ホーム › System.UpdateAgent › IUpdateLockdown

IUpdateLockdown

COM

IIDa976c28d-75a1-42aa-94ae-8af8b872089a継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

このインターフェイスのメソッドを実装するオブジェクトのメソッドおよびプロパティへのアクセスを制限します。

解説(Remarks)

IUpdateLockdown インターフェイスは、IDispatch ではなく IUnknown から派生しています。スクリプトを使用してアクセスすることはできません。このインターフェイスは、Windows Update Web サイトへのアクセスを制限します。

次のクラスが IUpdateLockdown インターフェイスを実装します。

AutomaticUpdates
UpdateDownloader
UpdateInstaller
UpdateServiceManager
WebProxy

メソッド 1

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT LockDown(INT flags)

このメソッドを実装するオブジェクトのメソッドおよびプロパティへのアクセスを制限します。

flags

INT

Windows Update Web サイトからさまざまな Windows Update Agent (WUA) オブジェクトへのアクセスを制限するオプションです。

このパラメーターに uloForWebsiteAccess または 1 を設定すると、IUpdateLockdown インターフェイスを実装する WUA インターフェイスへのアクセスが制限されます。

この値を指定したときに WUA インターフェイスが制限するメソッドおよびプロパティの一覧については、「解説」セクションを参照してください。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

次の表は、IUpdateLockdown インターフェイスを実装するインターフェイスを示しています。

WUA オブジェクト	制限されるメソッドおよびプロパティ
IAutomaticUpdates	Pause Resume
IAutomaticUpdatesSettings	Save
IUpdate	AcceptEula CopyFromCache CopyToCache
IUpdateDownloader	BeginDownload Download EndDownload IsForced (設定不可)
IUpdateInstaller	BeginInstall BeginUninstall EndInstall EndUninstall Install IsForced (設定不可) Uninstall
IUpdateServiceManager	AddScanPackageService RemoveService SetOption
IWebProxy	Address (設定不可) AutoDetect (設定不可) BypassList (設定不可) BypassProxyOnLocal (設定不可) SetPassword UserName (設定不可)

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

#define global IID_IUpdateLockdown "{A976C28D-75A1-42AA-94AE-8AF8B872089A}"
#usecom global IUpdateLockdown IID_IUpdateLockdown "{}"
#comfunc global IUpdateLockdown_LockDown  3 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。