DeletePrinterDataEx 函式

DeletePrinterDataEx函式會從印表機的組態資料中刪除指定的值。印表機的組態資料是由一組儲存在登錄機碼階層中的具名和具型別值所組成。函式會在指定的索引鍵下刪除指定的值。

如同DeletePrinterData 函式，DeletePrinterDataEx可以刪除SetPrinterData函式所儲存的值。此外， DeletePrinterDataEx 可以刪除 SetPrinterDataEx 函式儲存在指定索引鍵下的值。

語法

DWORD DeletePrinterDataEx(
  _In_ HANDLE  hPrinter,
  _In_ LPCTSTR pKeyName,
  _In_ LPCTSTR pValueName
);

hPrinter [in]

函式刪除值的印表機控制碼。使用 OpenPrinter 或 AddPrinter 函式來擷取印表機控制碼。

pKeyName [in]

Null 終止字串的指標，指定要刪除之值的索引鍵。使用反斜線 ( \ ) 字元做為分隔符號來指定具有一或多個子機碼的路徑。

如果 pKeyName 為 Null 或空字串， DeletePrinterDataEx 會傳回ERROR_INVALID_PARAMETER。

pValueName [in]

指定要刪除之值名稱之 Null 終止字串的指標。

如果函式成功，傳回值會ERROR_SUCCESS。

如果函式失敗，則傳回值是系統錯誤碼。

注意

這是封鎖或同步函式，可能不會立即傳回。此函式傳回的速度取決於執行時間因素，例如網路狀態、列印伺服器組態，以及難以在撰寫應用程式時預測的印表機驅動程式實作因素。從管理與使用者介面互動的執行緒呼叫此函式，可能會讓應用程式看起來沒有回應。

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	Winspool.h (包含 Windows.h)
程式庫	Winspool.lib
DLL	Winspool.drv
Unicode 與 ANSI 名稱	DeletePrinterDataExW (Unicode) 和 DeletePrinterDataExA (ANSI)