Функция NDdeShareEnum

Статья
06/13/2023

[Сетевое 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]: Зарезервировано. Этот параметр должен быть равен нулю.
lpBuffer [out]: Указатель на буфер, который получает список общих папок DDE. Список общих папок DDE хранится в виде последовательности строк, разделенных значением NULL, завершающимся с двойным символом NULL в конце. Этот параметр может принимать значение NULL. Если lpBuffer имеет значение NULL, DSDM возвращает размер буфера, необходимый для хранения списка общих папок в параметре lpcbTotalAvailable .
cBufSize [in]: Размер буфера lpBuffer в байтах. Этот параметр должен иметь нулевое значение, если lpBuffer имеет значение NULL.
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
Имя в кодировке Юникод и ANSI	NDdeShareEnumW (Юникод) и NDdeShareEnumA (ANSI)

См. также раздел

Общие сведения о сетевом динамическом обмене данными
Сетевые функции DDE

Поделиться через