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 関数は、シェルのショートカット フックが機能しない場合に使用することを目的としています。 たとえば、スタート メニューにインストールされていないアプリケーションがあります。 そのアプリケーションが独自のソフトウェア更新チェックを実行する必要がある場合は、この関数を使用する必要があります。

Requirements