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 を返す必要があります。

注釈

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

Point と Print DLL は、サーバーとクライアントの両方で実行されます。 SpoolerCopyFileEvent 関数は、イベントを示すフラグを提供する dwCopyFileEvent の内容を読み取ることで、それが実行されている場所を特定できます。 関数はイベントを処理し、 を返す必要があります。 処理が必要ない場合、関数は TRUE を返すだけです。

dwCopyFileEvent がCOPYFILE_EVENT_ADD_PRINTER_CONNECTIONまたはCOPYFILE_EVENT_ADD_PRINTER_CONNECTION場合、pszPrinterName によって提供される文字列にはサーバー名が含まれます。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	winsplp.h (Winsplp.h を含む)
Library	Mscms.lib
[DLL]	Mscms.dll

こちらもご覧ください

GenerateCopyFilePaths