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

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

リターン コード 説明
IDNO
 ユーザーがダイアログ ボックスの [ 更新しない ] ボタンをクリックしました。
IDYES
 ユーザーが [ 今すぐ更新 ] または [ 更新プログラムについて ] ボタンをクリックしました。 アプリケーションは、psdi が指す構造体の szHREF メンバーによって参照される HTML ページに移動する必要があります。
IDIGNORE
 保留中のソフトウェア更新プログラムはありません。
IDABORT
 エラーが発生しました。

解説

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

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

要件

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