Share via

NPPropertyDialog 関数 (npapi.h)

  • [アーティクル]

ユーザーが NPPropertyDialog 関数を使用して追加されたボタンをクリックしたときに呼び出されます。 NPPropertyDialog 関数は、ファイルとディレクトリのネットワーク プロパティに対してのみ呼び出されます。

構文

DWORD NPPropertyDialog(
  [in] HWND   hwndParent,
  [in] DWORD  iButtonDlg,
  [in] DWORD  nPropSel,
  [in] LPWSTR lpFileName,
  [in] DWORD  nType
);

パラメーター

[in] hwndParent

ファイル プロパティ ダイアログ ボックスを所有する親ウィンドウへのハンドル。

[in] iButtonDlg

押されたボタンのインデックス。

このインデックスは、 NPGetPropertyText 関数から返される最初のボタンのダイアログ ボックスから開始して、要求されたプロパティ ダイアログ ボックスを指定します。 複数のファイル名が選択されている場合は、この番号に 10 が追加されます。 つまり、複数のファイルが選択されていて、ユーザーが最初のプロバイダー定義プロパティ ボタンを押すと、 iButtonDlg は 11 になります。 ファイルが 1 つしか選択されておらず、ユーザーが 2 番目のネットワーク プロパティ ボタンを押すと、 iButtonDlg は 2 になります。

[in] nPropSel

プロパティ ダイアログ ボックスが動作するアイテムを指定します。 このパラメーターには、次の値のいずれかを指定できます。

値 意味
WNPS_FILE
 1 つのファイル。
WNPS_DIR
 1 つのディレクトリ。
WNPS_MULT
 複数のファイル、ディレクトリ、またはその両方の選択。

[in] lpFileName

プロパティ ダイアログ ボックスが動作する項目の名前へのポインター。 サポートされている項目はファイルとディレクトリのみであるため、項目名はファイル名です。 これらは明確で、ワイルドカード文字を含めず、完全修飾にする必要があります (例 : C:\Local\Example.doc)。複数のファイル名はスペースで区切る必要があります。 スペースを含むファイル名は、 "C:\My File" のように引用符で囲むことができます。 この場合、単一の名前として扱われます。 キャレット (^) は、C:\My^"File や "C:\My^"File" など、単一文字のクォート メカニズムとしても使用できます。どちらも C:\My"File というファイルを参照します。

[in] nType

WNTYPE_FILEする必要がある項目の種類を指定します。

戻り値

関数が成功すると、WN_SUCCESSが返されます。 関数が失敗した場合はエラー コードを返します。 SetLastError を呼び出して、この拡張エラー コードを設定します。これには、次のリターン コードが含まれる場合があります。

リターン コード 説明
WN_BAD_VALUE
 1 つ以上のパラメーターが予期しない形式または値です。
WN_OUT_OF_MEMORY
 ダイアログ ボックスを表示するためのメモリが不足しています。
WN_NET_ERROR
 ネットワーク エラーが発生しました。

注釈

この関数は、 NPGetPropertyText がボタン名を割り当てたプロパティのセットでのみ呼び出されます。

この関数は、ネットワーク デバイス上のファイルのネットワーク プロパティ (アクセス許可など) を表示および変更するために、ファイル マネージャーで使用されます。 この関数がサポートされていない場合、ファイル マネージャーでは既定の動作は提供されません。

このバージョンのネットワーク プロバイダー インターフェイスでは、 lpFileName は ファイル名のみを指すことができます。 ネットワーク プロバイダーは、不適切なデバイスが表示された場合はWN_BAD_VALUEを返す必要があります。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー npapi.h

こちらもご覧ください

NPGetPropertyText

SetLastError