PF_NPPropertyDialog
コールバックシグネチャ
DWORD PF_NPPropertyDialog(
HWND hwndParent,
DWORD iButtonDlg,
DWORD nPropSel,
LPWSTR lpFileName,
DWORD nType
);パラメーター
| フィールド | 型 | 説明 | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| hwndParent | HWND | ファイルのプロパティダイアログボックスを所有する親ウィンドウへのハンドルです。 | ||||||||
| iButtonDlg | DWORD | 押されたボタンのインデックスです。 このインデックスは、どのプロパティダイアログボックスが要求されたかを示します。インデックスは、 the NPGetPropertyText 関数から返された最初のボタンを 1 として始まります。複数のファイル名が選択されている場合は、この数値に 10 が加算されます。つまり、複数のファイルが選択されている状態でユーザーがプロバイダー定義の最初のプロパティボタンを押した場合、iButtonDlg は 11 になります。1 つのファイルだけが選択されている状態でユーザーが 2 番目のネットワークプロパティボタンを押した場合、iButtonDlg は 2 になります。 | ||||||||
| nPropSel | DWORD | プロパティダイアログボックスが操作対象とする項目を指定します。このパラメーターには、次のいずれかの値を指定できます。
| ||||||||
| lpFileName | LPWSTR | プロパティダイアログボックスが操作対象とする項目の名前へのポインターです。サポートされる項目はファイルとディレクトリのみであるため、項目名はファイル名になります。ファイル名は一意に定まるものであり、ワイルドカード文字を含まず、完全修飾されている必要があります。たとえば C:\Local\Example.doc のように指定します。複数のファイル名はスペースで区切ります。スペースを含むファイル名は、たとえば "C:\My File" のように引用符で囲むことができます。この場合、1 つの名前として扱われます。1 文字単位の引用符として、キャレット (^) を使用することもできます。たとえば C:\My^"File と "C:\My^"File" は、どちらもファイル C:\My"File を指します。 | ||||||||
| nType | DWORD | 項目の種類を指定します。WNTYPE_FILE である必要があります。 |
公式ドキュメント
NPPropertyDialog 関数を使用して追加されたボタンをユーザーがクリックしたときに呼び出されます。NPPropertyDialog 関数は、ファイルおよびディレクトリのネットワークプロパティに対してのみ呼び出されます。
戻り値
関数が成功した場合は WN_SUCCESS を返します。関数が失敗した場合はエラーコードを返します。この拡張エラーコードを設定するには SetLastError を呼び出します。エラーコードには次のものが含まれる場合があります。
| リターンコード | 説明 |
|---|---|
|
1 つ以上のパラメーターの形式または値が予期しないものです。 |
|
ダイアログボックスを表示するためのメモリが不足しています。 |
|
ネットワークエラーが発生しました。 |
解説(Remarks)
この関数は、 NPGetPropertyText がボタン名を割り当てたプロパティのセットに対してのみ呼び出されます。
この関数は、ネットワークデバイス上のファイルのネットワークプロパティ (アクセス許可など) を表示および変更するために File Manager で使用されます。この関数がサポートされていない場合、File Manager は既定の動作を提供しません。
このバージョンのネットワークプロバイダーインターフェイスでは、lpFileName はファイル名のみを指すことができます。ネットワークプロバイダーは、不適切なデバイスを検出した場合は WN_BAD_VALUE を返す必要があります。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)