SPFILENOTIFY_NEEDNEWCABINET メッセージ

  • [アーティクル]

SPFILENOTIFY_NEEDNEWCABINET通知は SetupIterateCabinet によって送信され、現在のファイルが別のキャビネットで続行されることを示します。 その後、コールバック ルーチンで SetupPromptForDisk を呼び出すか、独自のダイアログ ボックスを作成して、ユーザーに次のディスクを挿入するように求めることができます。

SPFILENOTIFY_NEEDNEWCABINET
  Param1 = (UINT) CabinetInfo;
  Param2 = (UINT) NewPath;

パラメーター

Param1

キャビネットと抽出するファイルに関する情報を含む CABINET_INFO構造体への ポインター。

Param2

コールバックがNO_ERRORを返す場合、このパラメーターは null で終わる文字列へのポインターです。 文字列が空でない場合は、キャビネットへの新しいパスを指定します。

戻り値

ルーチンは、次のいずれかの値を返す必要があります。

リターン コード 説明
NO_ERROR
 エラーが発生せず、キャビネットの処理を続行します。
ERROR_XXX
 指定した型のエラーが発生しました。 SetupIterateCabinet 関数は FALSE を返し、指定されたエラー コードは GetLastError の呼び出しによって返されます。

Note

既定のキャビネット コールバック ルーチンはありません。したがって、 SetupIterateCabinet によって送信される通知を処理するコールバック ルーチンを指定する必要があります。

注釈

コールバック ルーチンがNO_ERRORを返す場合、 SetupIterateCabinet は Param2 が指すバッファーをチェックします。 バッファーが空でない場合は、新しいソース パスが含まれます。 バッファーが空の場合、ソース パスは変更されていないと見なされます。

コールバック関数は、新しいメディアを挿入する必要がある場合に SetupPromptForDisk 関数を呼び出して、キャビネットが返される前にアクセス可能であることを確認する必要があります。

要件

要件 値
サポートされている最小のクライアント
 Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2003 [デスクトップ アプリのみ]
Header
Setupapi.h

関連項目

概要

通知

CABINET_INFO

SetupIterateCabinet