Функция NDdeShareGetInfo

Статья
06/13/2023

[Сетевое DDE больше не поддерживается. Nddeapi.dll присутствует в Windows Vista, но все вызовы функций возвращают NDDE_NOT_IMPLEMENTED.]

Извлекает сведения об общем ресурсе DDE. Обычно это делается для редактирования.

Синтаксис

UINT NDdeShareGetInfo(
  _In_  LPTSTR  lpszServer,
  _In_  LPTSTR  lpszShareName,
  _In_  UINT    nLevel,
  _Out_ LPBYTE  lpBuffer,
  _In_  DWORD   cBufSize,
  _Out_ LPDWORD lpnTotalAvailable,
  _In_  LPWORD  lpnItems
);

Параметры

lpszServer [in]: Имя сервера, на котором находится DSDM.
lpszShareName [in]: Имя общей папки, сведения о которой необходимо извлечь из DSDM. Этот параметр не должен иметь значение NULL.
nLevel [in]: Уровень сведений. Этот параметр должен иметь значение 2.
lpBuffer [out]: Указатель на буфер, который получает структуру NDDESHAREINFO и связанные данные, на которые указывают его члены. Этот параметр может принимать значение NULL. Если lpBuffer имеет значение NULL, DSDM вычисляет количество байтов, необходимых для хранения запрошенных сведений об общем ресурсе, и возвращает это значение в поле lpnTotalAvailable вместе с ошибкой NDDE_BUF_TOO_SMALL.
cBufSize [in]: Размер буфера lpBuffer в байтах. Если lpBuffer имеет значение NULL, то значение cBufSize должно быть равно нулю.
lpnTotalAvailable [out]: Указатель на переменную, получающую общее количество байтов, необходимых для хранения запрошенных сведений об общем ресурсе. Этот параметр не может иметь значение NULL.
lpnItems [in]: Указатель на маску выбора элементов для частичного получения сведений об общем ресурсе.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет NDDE_NO_ERROR.

Если функция завершается сбоем, возвращаемое значение представляет собой код ошибки, который можно преобразовать в текстовое сообщение об ошибке, вызвав NDdeGetErrorString. Если параметр lpBuffer имеет значение NULL, он возвращает NDDE_BUF_TOO_SMALL.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Заголовок	Nddeapi.h
Библиотека	Nddeapi.lib
DLL	Nddeapi.dll
Имя в кодировке Юникод и ANSI	NDdeShareGetInfoW (Юникод) и NDdeShareGetInfoA (ANSI)

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

Обзор сетевого динамического обмена данными
Сетевые функции DDE
NDDESHAREINFO
NDdeShareSetInfo

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