DdeNameService 関数 (ddeml.h)
動的データ交換 (DDE) サーバーがサポートするサービス名を登録または登録解除します。 この関数により、システムは実行中の他の動的データ交換管理ライブラリ (DDEML) クライアント アプリケーションにXTYP_REGISTERまたはXTYP_UNREGISTERトランザクションを送信します。
構文
HDDEDATA DdeNameService(
[in] DWORD idInst,
[in, optional] HSZ hsz1,
[in, optional] HSZ hsz2,
[in] UINT afCmd
);
パラメーター
[in] idInst
型: DWORD
DdeInitialize 関数の前回の呼び出しによって取得されたアプリケーション インスタンス識別子。
[in, optional] hsz1
種類: HSZ
サーバーが登録または登録解除しているサービス名を指定する文字列のハンドル。 すべてのサービス名の登録を解除するアプリケーションでは、このパラメーターを 0L に設定する必要があります。
[in, optional] hsz2
種類: HSZ
予約;は 0L に設定する必要があります。
[in] afCmd
型: UINT
サービス名のオプション。 このパラメーターには、次の値のいずれかを指定できます。
| 値 | 意味 |
|---|---|
|
エラー コード サービス名を登録します。 |
|
エラー コードサービス名の登録を解除します。 hsz1 パラメーターが 0L の場合、サーバーによって登録されているすべてのサービス名が登録解除されます。 |
|
サービス名の開始フィルター処理を有効にします。 このフィルターは、サーバーが登録されていないサービス名 のXTYP_CONNECT トランザクションを受信できないようにします。 これは、このフィルターの既定の設定です。
サーバー アプリケーションがサービス名を登録していない場合、アプリケーションは XTYP_WILDCONNECT トランザクションを受信できません。 |
|
サービス名の開始フィルター処理をオフにします。 このフラグを指定すると、サービス名に関係なく、別の DDE アプリケーションが DdeConnect 関数を呼び出すたびに、サーバーはXTYP_CONNECTトランザクションを受け取ります。 |
戻り値
種類: HDDEDATA
関数が成功すると、0 以外の値が返されます。 この値は、真の HDDEDATA 値ではなく、単なる成功のブール値インジケーターです。 関数は HDDEDATA と入力され、関数の将来の拡張とより高度な戻り値を可能にします。
関数が失敗した場合、戻り値は 0L です。
DdeGetLastError 関数を使用してエラー コードを取得できます。次のいずれかの値を指定できます。
解説
hsz1 パラメーターで識別されるサービス名は、ベース名である必要があります (つまり、名前にはインスタンス固有の情報を含めてはなりません)。 システムはインスタンス固有の名前を生成し、 XTYP_REGISTER および XTYP_UNREGISTER トランザクション中にベース名と共に送信します。 受信側のアプリケーションは、特定のアプリケーション インスタンスに接続できます。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | ddeml.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |
関連項目
概念
リファレンス