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


Функция 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]

Зарезервировано. Этот параметр должен быть равен нулю.

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