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


Структура NDDESHAREINFO

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

Содержит атрибуты общего ресурса DDE, поддерживаемые диспетчером общих баз данных NetDDE (DSDM). Дескриптор безопасности, связанный с каждой общей папкой DDE, не передается через эту структуру, а осуществляется через определенные функции. API NetDDE DSDM принимает эту структуру для функций set; для функций get DSDM возвращает структуру, упакованную в предоставленный буфер, вместе с данными, на которые ссылаются члены lpszShareName, lpszAppTopicList и lpszItemList.

Синтаксис

typedef struct _NDDESHAREINFO {
  LONG   lRevision;
  LPTSTR lpszShareName;
  LONG   lShareType;
  LPTSTR lpszAppTopicList;
  LONG   fSharedFlag;
  LONG   fService;
  LONG   fStartAppFlag;
  LONG   nCmdShow;
  LONG   qModifyId[2];
  LONG   cNumItems;
  LPTSTR lpszItemList;
} NDDESHAREINFO, *PNDDESHAREINFO;

Члены

lRevision

Уровень редакции структуры NDDESHAREINFO . В настоящее время уровень редакции равен 1.

lpszShareName

Имя общей папки. Эта строка должна содержать не более MAX_NDDESHARENAME символов.

lShareType

Один или несколько типов общих папок DDE. Этот член может быть сочетанием следующих поддерживаемых типов общих ресурсов DDE.

Тип общей папки Значение
SHARE_TYPE_NEW
0x02
Общая папка содержит пару приложений и разделов OLE.
SHARE_TYPE_OLD
0x01
Общая папка содержит пару приложений И разделов DDE.
SHARE_TYPE_STATIC
0x04
Общая папка содержит пару статических приложений и разделов.

lpszAppTopicList

Указатель на буфер, содержащий строки, завершающиеся значением NULL, для пар DDE, OLE и статических приложений и разделов. Буфер должен иметь следующий формат:

<DDE application name>|<DDE topic name>\0
<OLE application name>|<OLE topic name>\0
<static application name>|<static topic name>\0\0

fSharedFlag

Если этот элемент имеет значение FALSE, общий ресурс DDE не позволит удаленным пользователям обмениваться данными через него с помощью DDE. Однако локальные пользователи по-прежнему могут обмениваться данными через общую папку DDE. Локальные клиентские ссылки всегда подразумеваются, если связанный DACL предоставляет доступ.

fService

Если этот элемент задан, общий ресурс DDE не будет проверка, настроил ли текущий пользователь его как доверенный, прежде чем разрешить обмен данными по DDE.

fStartAppFlag

Если этот член задан и общий ресурс является доверенным для запуска приложений, NetDDE попытается запустить приложение, указанное в lpszAppTopicList , если ему не удается изначально запустить беседу DDE с приложением.

nCmdShow

Когда NetDDE запускает приложение для запуска диалога DDE, это значение отправляется в приложение с помощью параметра nCmdShow функции WinMain . Он определяет предпочтительный режим для отображения окна приложения. Этот параметр имеет значение, только если активна функция fStartAppFlag . Пользователь, вошедший в систему, в контексте которого запущено приложение, также может переопределить этот параметр при повышении уровня общего ресурса до доверенного состояния. По умолчанию для этого элемента используется SW_SHOWMAXIMIZED.

qModifyId

8-байтовый серийный номер, указывающий серийный номер изменения общей папки DDE. При каждом изменении общей папки DDE с помощью вызова NDdeShareSetInfo или NDdeSetShareSecurity эти значения изменяются.

cNumItems

Количество элементов, перечисленных в lpszItemList. Если cNumItems равно нулю, lpszItemList пуст, а общие сведения и связанный дескриптор безопасности применяются ко всем элементам, обслуживаемым связанным приложением.

lpszItemList

Указатель на буфер, содержащий строки со значением NULL, которые указывают элементы, которые клиентское приложение в транзакции DDE может запрашивать или запускать циклы консультирования. Если элементы не указаны, общий ресурс DDE позволяет использовать любой элемент. Количество элементов в списке должно соответствовать количеству cNumItems .

Требования

Требование Значение
Минимальная версия клиента
Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
Windows 2000 Server [только классические приложения]
Заголовок
Nddeapi.h

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

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

Сетевые структуры DDE

NDdeSetShareSecurity

NDdeShareSetInfo

WinMain