SoftwareUpdateMessageBox 関数 (shlobj.h)

アプリケーションが更新されたことをユーザーに通知するために使用できる標準メッセージ ボックスを表示します。

構文

DWORD SoftwareUpdateMessageBox(
  [in, optional]  HWND           hWnd,
  [in]            PCWSTR         pszDistUnit,
                  DWORD          dwFlags,
  [out, optional] LPSOFTDISTINFO psdi
);

パラメーター

[in, optional] hWnd

型: HWND

親ウィンドウへのハンドル。

[in] pszDistUnit

種類: PCWSTR

コード配布単位の識別子を含む文字列値。 ActiveX コントロールの場合、 pszDistUnit は通常 GUID です。

dwFlags

型: DWORD

予約済み。 0 に設定する必要があります。

[out, optional] psdi

種類: LPSOFTDISTINFO

このメソッドが正常に返されたときに更新情報を受け取る SOFTDISTINFO 構造体へのポインター。 cbSize メンバーは に初期化するsizeof(SOFTDISTINFO)必要があります。

戻り値

型: DWORD

次のいずれかの値を返します。

解説

更新プログラムを処理する推奨される方法は、Open Software Description (OSD) ボキャブラリを使用してチャネル定義形式 (CDF) を作成し、ショートカットを OSD 対応にすることです。 詳細については、 チャネル定義の形式 に関するドキュメントを参照してください。

SoftwareUpdateMessageBox 関数は、シェル ショートカット フックが機能しない場合に使用することを目的としています。 1 つの例として、スタート メニューにインストールされていないアプリケーションがあります。 そのアプリケーションが独自のソフトウェア更新プログラムチェックを実行する必要がある場合は、この関数を使用する必要があります。

要件