SpoolerCopyFileEvent 函式 (winsplp.h)

當用戶端連接到列印伺服器時，Point 和 Print DLL 的 SpoolerCopyFileEvent 函式會收到與將列印佇列相關聯檔案複製到列印用戶端相關聯的事件通知。

語法

BOOL SpoolerCopyFileEvent(
  [in] LPWSTR pszPrinterName,
  [in] LPWSTR pszKey,
  [in] DWORD  dwCopyFileEvent
);

參數

[in] pszPrinterName

呼叫端提供的字串指標，代表印表機名稱。

[in] pszKey

呼叫端提供的字串指標，代表印表機 CopyFiles 登錄機碼底下的子機碼。 這個子機碼會識別Point和 Print DLL 所屬的元件。

[in] dwCopyFileEvent

呼叫端提供的旗標，可識別所報告的事件。 下表包含有效的旗標值。

旗標	收到時	接收位置
COPYFILE_EVENT_ADD_PRINTER_CONNECTION	用戶端應用程式呼叫 AddPrinterConnection 之後。	的 SpoolerCopyFileEvent客戶端複本。 呼叫內容是客戶端應用程式。
COPYFILE_EVENT_DELETE_PRINTER	呼叫 DeletePrinter 之後。	的 SpoolerCopyFileEvent客戶端複本。 呼叫內容是用戶端的後台處理程式。
COPYFILE_EVENT_DELETE_PRINTER_CONNECTION	用戶端應用程式呼叫 DeletePrinterConnection之後。	的 SpoolerCopyFileEvent客戶端複本。 呼叫內容是客戶端應用程式。
COPYFILE_EVENT_FILES_CHANGED	用戶端下載印表機 CopyFiles 登錄機碼之 pszKey 子機碼下指定的檔案之後。	的 SpoolerCopyFileEvent客戶端複本。 呼叫內容是用戶端的後台處理程式。
COPYFILE_EVENT_SET_PRINTER_DATAEX	在伺服器上處理 SetPrinterDataEx 的呼叫之後。	的伺服器 SpoolerCopyFileEvent複本。 呼叫內容是藉由仿真的客戶端應用程式。

傳回值

如果函式發生錯誤，函式應該會傳回 FALSE。 否則，它應該會傳回 TRUE。

備註

所有 Point 和 Print DLL 都必須匯出由列印後台處理程式呼叫的 SpoolerCopyFileEvent 函式。 其目的是允許當用戶端上的應用程式連接到伺服器時，讓 Point 和 Print DLL 收到與列印佇列相關聯檔案下載相關事件的相關通知，從列印伺服器到客戶端系統。 如需建立點和印表連線相關步驟的完整描述，請參閱 支援點和列印。

點和列印 DLL 會在伺服器和用戶端上執行。 SpoolerCopyFileEvent 函式可以藉由讀取 dwCopyFileEvent 的內容來判斷其執行位置，其中提供指出事件的旗標。 函式應該會處理 事件並傳回。 如果不需要任何處理，函式應該只會傳回 TRUE。

如果 dwCopyFileEvent 是COPYFILE_EVENT_ADD_PRINTER_CONNECTION或 COPYFILE_EVENT_ADD_PRINTER_CONNECTION，pszPrinterName 所提供的字串會包含伺服器名稱。

規格需求

需求	值
目標平台	Universal
標頭	winsplp.h (包含 Winsplp.h)
程式庫	Mscms.lib
Dll	Mscms.dll

另請參閱

GenerateCopyFilePaths