Функция 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 [только классические приложения] |
Заголовок |
|
Библиотека |
|
DLL |
|
Имя в кодировке Юникод и ANSI |
NDdeShareGetInfoW (Юникод) и NDdeShareGetInfoA (ANSI) |