共用方式為

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。 如果只選取一個檔案，且使用者按下第二個網路屬性按鈕， iButtonDlg 會是兩個。

[in] nPropSel

指定屬性對話框應該處理的專案。 此參數可以是下列其中一個值。

值 意義
WNPS_FILE
 單一檔案。
WNPS_DIR
 單一目錄。
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 來設定此擴充錯誤碼，其中可能包含下列傳回碼。

傳回碼 Description
WN_BAD_VALUE
 一或多個參數是非預期的窗體或值。
WN_OUT_OF_MEMORY
 記憶體不足，無法顯示對話方塊。
WN_NET_ERROR
 發生網路錯誤。

備註

此函式只會在 NPGetPropertyText 已指派按鈕名稱的屬性集上呼叫。

此函式用於檔案管理員，以檢視和修改網路屬性 (例如網路裝置上檔案的許可權) 。 如果不支援此函式，檔案管理員不會提供任何預設行為。

在這個版本的網路介面中， lpFileName 只能指向檔名。 如果網路提供者看到不適當的裝置，網路提供者應該會傳回WN_BAD_VALUE。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 npapi.h

另請參閱

NPGetPropertyText

SetLastError