こちらから - インタフェース

GPG-8826 Help for Linux
10. IfHnlWindowGetHandle
【 機 能 】
IfHnlWindowOpen 関 数 によって 割 り 当 てられたウィンドウのハンドルを 取 得 します。
ウィンドウをシェアして 使 う 場 合 に 使 用 してください。
【 書 式 】
●C 言 語
Unsigned long IfHnlWindowGetHandle (
unsigned long DeviceHandle, // デバイスハンドル
unsigned long Ch // チャンネル
);
【パラメータ】
DeviceHandle
IfHnlOpen 関 数 で 取 得 したデバイスハンドルを 指 定 してください。
Ch
IfHnlWindowOpen 関 数 によってオープンしているLinkウィンドウまたはVirtualウィンドウ
のチャンネルを 指 定 してください。
【 戻 り 値 】
正 常 に 終 了 した 場 合 には、 有 効 なウィンドウハンドルが 返 されます。
本 関 数 により 取 得 したウィンドウハンドルを 使 用 してウィンドウの 制 御 を 行 えます。
ウィンドウのハンドル 取 得 に 失 敗 した 場 合 には、INVALID_HANDLE_VALUE(-1)が 返 されます。
拡 張 エラー 情 報 を 取 得 するには、IfHnlGetLastError 関 数 を 使 います。
拡 張 エラー 情 報 の 内 容 は『4.5 戻 り 値 一 覧 』をご 参 照 ください。
取 得 出 来 るエラーコードは、 独 自 のエラーコードとなります。
【 備 考 】
・IfHnlWindowOpen 関 数 によってオープンしていない 場 合 、ハンドルは 取 得 できません。
・IfHnlWindowOpen 関 数 実 行 時 の 戻 り 値 でINVALID_HANDLE_VALUE(-1)が 返 され、
GetLastError 関 数 を 使 い、 拡 張 エラー 情 報 を 取 得 し、IFHNL_ERROR_ALREADY_OPEN(C0000004h)
が 取 得 できた 場 合 、この 関 数 でのハンドル 取 得 が 可 能 です。
・IfHnlWindowClose 関 数 によってクローズしてしまったウィンドウのハンドルでは 共 有 メモリ
へアクセスできません。ウィンドウのクローズは 使 用 しなくなったときに 行 ってください。
【 使 用 例 】
付 属 のサンプルプログラムをご 参 照 ください。
© 2012, 2013 Interface Corporation. All rights reserved.
35