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

サービス名のオプション。 このパラメーターには、次の値のいずれかを指定できます。

値 意味
DNS_REGISTER
0x0001
 エラー コード サービス名を登録します。
DNS_UNREGISTER
0x0002
 エラー コードサービス名の登録を解除します。 hsz1 パラメーターが 0L の場合、サーバーによって登録されているすべてのサービス名が登録解除されます。
DNS_FILTERON
0x0004
 サービス名の開始フィルター処理を有効にします。 このフィルターは、サーバーが登録されていないサービス名 のXTYP_CONNECT トランザクションを受信できないようにします。 これは、このフィルターの既定の設定です。

サーバー アプリケーションがサービス名を登録していない場合、アプリケーションは XTYP_WILDCONNECT トランザクションを受信できません。
DNS_FILTEROFF
0x0008
 サービス名の開始フィルター処理をオフにします。 このフラグを指定すると、サービス名に関係なく、別の 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

関連項目

概念

DdeConnect

DdeConnectList

DdeInitialize

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

リファレンス

XTYP_REGISTER

XTYP_UNREGISTER