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 |