Функция NDdeTrustedShareEnum

  • Статья

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

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

Синтаксис

UINT NDdeTrustedShareEnum(
  _In_  LPTSTR  lpszServer,
  _In_  UINT    nLevel,
  _Out_ LPBYTE  lpBuffer,
  _In_  DWORD   cBufSize,
  _Out_ LPDWORD lpnEntriesRead,
  _Out_ LPDWORD lpcbTotalAvailable
);

Параметры

lpszServer [in]

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

nLevel [in]

Зарезервировано. Этот параметр должен быть равен нулю.

lpBuffer [out]

Указатель на буфер, который получает список доверенных общих папок DDE. Список доверенных общих папок DDE возвращается в виде последовательности строк с разделительным значением NULL, завершающимся двойным символом NULL в конце. Этот параметр может принимать значение NULL. Если lpBuffer имеет значение NULL, DSDM возвращает размер буфера, необходимый для хранения списка общих папок в поле lpcbTotalAvailable .

cBufSize [in]

Размер буфера lpBuffer в байтах. Этот параметр должен иметь нулевое значение, если lpBuffer имеет значение NULL.

lpnEntriesRead [out]

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

lpcbTotalAvailable [out]

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

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

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

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

Требования

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

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

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

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