共用方式為

NPGetPropertyText 函式 (npapi.h)

  • 發行項

擷取要新增至網路資源之屬性對話框的按鈕名稱。

語法

DWORD NPGetPropertyText(
  [in]      DWORD  iButton,
  [in]      DWORD  nPropSel,
  [in]      LPWSTR lpName,
  [out]     LPWSTR lpButtonName,
  [in, out] DWORD  nButtonNameLen,
  [in]      DWORD  nType
);

參數

[in] iButton

指出按鈕的索引。 檔案管理員最多支援六個按鈕。 如果只選取一個檔案，則每個可能按鈕的編號為 1-6，如果選取多個檔案，則為 11-16。

[in] nPropSel

指定屬性對話框著重於哪些專案。 這可以是下列其中一個值。

值 意義
WNPS_FILE
 單一檔案。
WNPS_DIR
 單一目錄。
WNPS_MULT
 選取多個檔案、目錄或兩者。

[in] lpName

Null 終止字串的指標，其中包含要透過對話框檢視或編輯之項目的名稱。 唯一支援的專案是檔案和目錄，因此專案名稱是檔名。 這些應該不明確、不包含通配符，而且 (完整，例如，C:\LOCAL\EXAMPLE.DOC) 。 多個檔名應該以空格分隔。 包含空格的檔名可能會以引號括住，例如“C：\My File”) (。 在此情況下。 它會被視為單一名稱。 插入號字元 『^』 也可以用來做為單一字元的引號機制 (，例如 C：\My^“File、”C：\My^“File” 兩者都參考 C：\My“File) 。

[out] lpButtonName

網路提供者應該複製屬性按鈕名稱的緩衝區指標。 成功時， lpButtonName 所指向的緩衝區包含屬性按鈕的名稱。 如果這個緩衝區在結束時包含空字串，則對應至該名稱的按鈕，且所有成功的按鈕都會從對話框中移除。 網路提供者無法「略過」按鈕。

[in, out] nButtonNameLen

指定 字元中 lpButtonName 緩衝區的大小，包括終止的 Null 字元。

[in] nType

指定專案類型，必須WNTYPE_FILE。

傳回值

如果函式成功，它應該會傳回WN_SUCCESS，而且可以使用 lpButtonName 。 如果指向空字串，則沒有按鈕對應至 與iButton 相同的索引。 如果傳回值不是WN_SUCCESS，提供者也應該呼叫 SetLastError 來設定擴充錯誤資訊。 延伸的錯誤碼包括下列專案。

傳回碼 Description
WN_OUT_OF_MEMORY
 無法從資源載入字串。
WN_MORE_DATA
 指定的緩衝區太小，無法容納按鈕的文字。
WN_BAD_VALUE
 lpName 參數是非預期的形式。
WN_NOT_SUPPORTED
 指定的物件類型 nType 不支援屬性對話框。

備註

檔案管理員會在每次啟動屬性對話框時呼叫此函式，並在顯示對話方塊之前執行此動作。 如果使用者單擊網路提供者透過此函式新增的按鈕，則會使用適當的參數呼叫 NPPropertyDialog 函式。

只有檔案管理員會呼叫 NPGetPropertyText，而且它會針對檔案和目錄使用此函式。

規格需求

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