Функция NDdeShareGetInfo

  • Статья

[Сетевое 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