Структура 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 [только классические приложения] |
Заголовок |
|