Функция NDdeGetTrustedShare

Статья
06/13/2023

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

Извлекает параметры, связанные с общим ресурсом DDE, который находится в списке доверенных общих папок пользователя сервера.

Синтаксис

UINT NDdeGetTrustedShare(
  _In_  LPTSTR  lpszServer,
  _In_  LPTSTR  lpszShareName,
  _Out_ LPDWORD lpdwTrustOptions,
  _Out_ LPDWORD lpdwShareModId0,
  _Out_ LPDWORD lpdwShareModId1
);

Параметры

lpszServer [in]

Имя сервера, на котором находится DSDM.

lpszShareName [in]

Имя общего ресурса, состояние доверия которого запрашивается. Этот параметр не может иметь значение NULL.

lpdwTrustOptions [out]

Указатель на переменную, получающую параметры доверия. Этот параметр не может иметь значение NULL. Доступны следующие параметры доверия.

Значение	Значение
NDDE_CMD_SHOW_MASK 0x0000FFFFL	Маска, используемая для получения значения, используемого для переопределения состояния отображения общей папки DDE, если задано NDDE_TRUST_CMD_SHOW.
NDDE_TRUST_CMD_SHOW 0x10000000L	Переопределите состояние отображения, указанное в общей папке DDE DSDM.
NDDE_TRUST_SHARE_DEL 0x20000000L	Удалите состояние доверия общей папки.
NDDE_TRUST_SHARE_INIT 0x40000000L	Разрешите клиенту инициировать приложение, если оно уже выполняется в контексте пользователя.
NDDE_TRUST_SHARE_START 0x80000000L	Разрешить запуск приложения в контексте пользователя.

lpdwShareModId0 [out]

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

lpdwShareModId1 [out]

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

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

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

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

Идентификатор изменения доверенного ресурса отражает версию общей папки DDE в DSDM на момент первоначального предоставления общей папке DDE статуса доверенного. Идентификатор изменения доверенного ресурса в основном используется для удаления устаревших доверенных общих папок. Однако пользователю не нужно удалять устаревшие доверенные общие папки. Сетевой агент DDE удаляет устаревшие общие папки от имени пользователя.

Требования

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

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

Общие сведения о сетевом динамическом обмене данными
Сетевые функции DDE
NDdeSetTrustedShare