DdeKeepStringHandle 関数 (ddeml.h)

指定したハンドルに関連付けられている使用数をインクリメントします。 この関数を使用すると、アプリケーションで、アプリケーションの Dynamic Data Exchange (DDE) コールバック関数に渡された文字列ハンドルを保存できます。 それ以外の場合、コールバック関数に渡された文字列ハンドルは、コールバック関数が返されるときに削除されます。 この関数は、DdeQueryConvInfo 関数によって返される CONVINFO 構造体によって参照される文字列ハンドルのコピーを保持するためにも使用する必要があります。

構文

BOOL DdeKeepStringHandle(
  [in] DWORD idInst,
  [in] HSZ   hsz
);

パラメーター

[in] idInst

型: DWORD

DdeInitialize 関数の以前の呼び出しによって取得されたアプリケーション インスタンス識別子。

[in] hsz

種類: HSZ

保存する文字列ハンドルへのハンドル。

戻り値

種類: BOOL

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー ddeml.h (Windows.h を含む)
Library User32.lib
[DLL] User32.dll

関連項目

CONVINFO

概念

DdeCreateStringHandle

DdeFreeStringHandle

DdeInitialize

DdeQueryConvInfo

DdeQueryString

動的データ交換管理ライブラリ

参照