SpoolerCopyFileEvent 関数 (winsplp.h)

Point and Print DLL の SpoolerCopyFileEvent 関数は、クライアントがプリント サーバーに接続するときに、印刷キューに関連付けられたファイルを印刷クライアントにコピーすることに関連するイベントの通知を受け取ります。

構文

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

パラメーター

[in] pszPrinterName

プリンター名を表す文字列への呼び出し元が指定したポインター。

[in] pszKey

プリンターの CopyFiles レジストリ キーの下にあるサブキーを表す文字列への呼び出し元指定のポインター。 このサブキーは、ポイントおよび印刷 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 返す必要があります。

備考

ポイントおよび印刷 DLL はすべて、印刷スプーラーによって呼び出される SpoolerCopyFileEvent 関数をエクスポートする必要があります。 その目的は、クライアント上のアプリケーションがサーバーに接続するときに、プリント サーバーからクライアント システムへの印刷キューに関連付けられたファイルのダウンロードに関連するイベントをポイントおよび印刷 DLL に通知できるようにすることです。 ポイントアンドプリント接続の作成に関連する手順の詳細については、「サポートポイントと印刷を参照してください。

ポイントおよび印刷 DLL は、サーバーとクライアントの両方で実行されます。 SpoolerCopyFileEvent 関数は、イベントを示すフラグを提供する dwCopyFileEvent の内容読み取ることで、実行場所を決定できます。 関数はイベントを処理して返す必要があります。 処理が不要な場合、関数は TRUE 返す必要があります。

dwCopyFileEvent がCOPYFILE_EVENT_ADD_PRINTER_CONNECTIONまたはCOPYFILE_EVENT_ADD_PRINTER_CONNECTIONの場合、pszPrinterName 指定された文字列にサーバー名が含まれます。

必要条件

要件	価値
ターゲット プラットフォーム の	万国
ヘッダー	winsplp.h (Winsplp.h を含む)
ライブラリ	Mscms.lib
DLL	Mscms.dll

関連項目

GenerateCopyFilePaths の