Tric_RequestStatusNotify

ステータスモニタへステータス通知要求を行います。ステータスモニタは、設定されたウィンドウハンドルを持つアプリケーションに対して WM_COPYDATA メッセージを送りプリンタからのデータを通知します。

short WINAPI Tric_RequestStatusNotify(
 LPSTR  lpszPrinterName,  // プリンタ名を示す NULL で終わる文字列へのポインタ(IN)
 HWND  hWnd,              // ステータスを通知するウィンドウハンドル(IN)
 LPDWORD  lpdwSMonID     // SmonIDを格納するバッファへのポインタ(OUT)
);
  

パラメータ

lpszPrinterName
調査対象とするプリンタのプリンタフレンドリ名を表す、NULLで終わる文字列へのポインタを指定します。

hWnd
WM_COPYDATAメッセージを受信するアプリケーションのウィンドウハンドルを指定します。ステータスモニタは、このウィンドウハンドルを持つアプリケーションに対してWM_COPYDATAメッセージを通知します。

lpdwSMonID
ステータスモニタ識別子の SMONID を格納するバッファへのポインタを指定します。

戻り値

エラーコードを返します。

解説

ステータスモニタからプリンタの情報を得る為に、この「Tric_RequestStatusNotify」を必ず実行する必要があります。
要求を解除するには、「Tric_ReleaseStatusNotify」を実行してください。
ステータスモニタへのステータス通知要求期間は、他のアプリケーションからこの「Tric_RequestStatusNotify」が実行されるまでか、「Tric_ReleaseStatusNotify」によって要求が解除されるまでです。

参照

index, Tric_ReleaseStatusNotify, SMONID, エラーコード
[Back]