Функция NDdeShareAdd

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

Создает и добавляет новую общую папку DDE в диспетчер баз данных общих ресурсов DDE (DSDM).

Синтаксис

UINT NDdeShareAdd(
  _In_ LPTSTR               lpszServer,
  _In_ UINT                 nLevel,
  _In_ PSECURITY_DESCRIPTOR pSD,
  _In_ LPBYTE               lpBuffer,
  _In_ DWORD                cBufSize
);

Параметры

lpszServer [in]

Имя сервера, dsdm которого требуется изменить.

nLevel [in]

Уровень сведений. Этот параметр должен иметь значение 2.

pSD [in]

Указатель на SECURITY_DESCRIPTOR структуру, которая будет связана с этой общей папкой и для которой будут выполняться проверки доступа при последующих запусках этой общей папки. Этот параметр может иметь значение NULL. В этом случае DSDM создает дескриптор безопасности по умолчанию, который предоставляет "Полный доступ" владельцу и "Чтение и связь" всем.

lpBuffer [ввод]

Указатель на структуру NDDESHAREINFO , которая определяет список ApplicationTopic, связанный с создаваемой общей папкой DDE, а также другие параметры. Этот параметр не может иметь значение NULL.

cBufSize [in]

Размер структуры lpBuffer в байтах. Этот параметр не может быть равен нулю.

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

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

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

Комментарии

Прежде чем клиент сможет подключиться к общей папке DDE, он должен быть доверенным с помощью NDdeSetTrustedShare.

Требования

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

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

Общие сведения о сетевом динамическом обмене данными

Сетевые функции DDE

NDDESHAREINFO

NDdeSetTrustedShare