共用方式為

PRINTER_INFO_7結構

  • 發行項

PRINTER_INFO_7結構會指定目錄服務印表機資訊。 使用這個結構搭配 SetPrinter 函 式，在目錄服務中發佈印表機的資料 (DS) ，或更新或移除印表機的發行資料。 搭配 GetPrinter 函式使用此結構來判斷印表機是否在 DS 中發佈。

語法

typedef struct _PRINTER_INFO_7 {
  LPTSTR pszObjectGUID;
  DWORD  dwAction;
} PRINTER_INFO_7, *PPRINTER_INFO_7;

成員

pszObjectGUID

Null 終止字串的指標，其中包含與已發行印表機相關聯之目錄服務列印佇列物件的 GUID。 使用 GetPrinter 函 式來擷取此 GUID。

在呼叫 SetPrinter之前，請將 pszObjectGUID 設定為 Null。

dwAction

指出 要執行的 SetPrinter 函 式動作。 對於 GetPrinter 函式，這個成員會指出指定的印表機是否已發佈。 這個成員可以是下列值的組合。

值 意義
DSPRINT_PENDING
0x80000000
 GetPrinter：指出系統嘗試完成 SetPrinter 呼叫所啟動的發佈或取消發佈作業。
SetPrinter：這個值無效。
DSPRINT_PUBLISH
0x00000001
 SetPrinter：在 DS 中發佈印表機的資料。
GetPrinter：指出印表機已發佈。
DSPRINT_REPUBLISH
0x00000008
 SetPrinter：印表機的 DS 資料會取消發佈，然後再次發佈，重新整理已發行印表機中的所有屬性。 重新發佈也會變更已發行印表機的 GUID。
GetPrinter：永不傳回此值。
DSPRINT_UNPUBLISH
0x00000004
 SetPrinter：從 DS 移除印表機的已發佈資料。
GetPrinter：指出印表機未發佈。
DSPRINT_UPDATE
0x00000002
 SetPrinter：更新印表機在 DS 中發佈的資料。
GetPrinter：永不傳回此值。

備註

PRINTER_INFO_7結構用於SetPrinter呼叫中，以將印表機資訊發佈至目錄服務。 已發佈的資料包括在 SetPrinterDataEx所建立SPLDS_SPOOLER_KEY、SPLDS_DRIVER_KEY或SPLDS_USER_KEY機碼下所指定印表機的所有值和資料。

針對 SetPrinter， pszObjectGUID 應設定為 Null。 針對 GetPrinter， pszObjectGUID 會傳回與已發行印表機相關聯的目錄服務列印佇列物件的 GUID。 您可以使用此 GUID 搭配 Active Directory 服務介面 (ADSI) 方法來擷取印表機的已發佈資料。 不過，擷取已發佈資料的建議方法是呼叫 GetPrinterDataEx 函 式。

規格需求

需求 值
最低支援的用戶端
 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
 Windows 2000 Server [僅限桌面應用程式]
標頭
Winspool.h (包含 Windows.h)
Unicode 與 ANSI 名稱
 _PRINTER_INFO_7W (Unicode) 和 _PRINTER_INFO_7A (ANSI)

另請參閱

列印

列印多工緩衝處理常式 API 結構