NDdeShareEnum 関数

[ネットワーク DDE はサポートされなくなりました。 Nddeapi.dllは Windows Vista に存在しますが、すべての関数呼び出しはNDDE_NOT_IMPLEMENTEDを返します。

使用可能な DDE 共有の一覧を取得します。

構文

UINT NDdeShareEnum(
  _In_  LPTSTR  lpszServer,
  _In_  UINT    nLevel,
  _Out_ LPBYTE  lpBuffer,
  _In_  DWORD   cBufSize,
  _Out_ LPDWORD lpnEntriesRead,
  _Out_ LPDWORD lpcbTotalAvailable
);

パラメーター

lpszServer [in]

DSDM が存在するサーバーの名前。

nLevel [in]

予約済み。 このパラメーターは 0 である必要があります。

lpBuffer [out]

DDE 共有の一覧を受け取るバッファーへのポインター。 DDE 共有のリストは、末尾に 2 つの null 文字で終わる null で区切られた文字列のシーケンスとして格納されます。 このパラメーターは、NULL でもかまいません。 lpBufferNULL の場合、DSDM は lpcbTotalAvailable パラメーター内の共有のリストを保持するために必要なバッファーのサイズを返します。

cBufSize [in]

lpBuffer バッファーのサイズ (バイト単位)。 lpBufferNULL の場合、このパラメーターは 0 である必要があります。

lpnEntriesRead [out]

列挙される共有の合計数を受け取る変数へのポインター。 このパラメーターを NULL にすることはできません。

lpcbTotalAvailable [out]

DDE 共有のリストを格納するためにバッファーに必要な合計バイト数を受け取る変数へのポインター。 このパラメーターを NULL にすることはできません。

戻り値

関数が成功した場合、戻り値はNDDE_NO_ERROR。

関数が失敗した場合、戻り値はエラー コードであり、 NDdeGetErrorString を呼び出すことでテキスト エラー メッセージに変換できます。 lpBuffer パラメーターが NULL の場合は、NDDE_BUF_TOO_SMALLを返します。

要件

要件
サポートされている最小のクライアント
Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー
Nddeapi.h
ライブラリ
Nddeapi.lib
[DLL]
Nddeapi.dll
Unicode 名と ANSI 名
NDdeShareEnumW (Unicode) と NDdeShareEnumA (ANSI)

関連項目

ネットワーク動的データ交換の概要

ネットワーク DDE 関数