Функция NDdeGetShareSecurity

  • Статья

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

Извлекает дескриптор безопасности, связанный с общей папкой DDE. Обычно это делается для редактирования.

Синтаксис

UINT NDdeGetShareSecurity(
  _In_  LPTSTR               lpszServer,
  _In_  LPTSTR               lpszShareName,
  _In_  SECURITY_INFORMATION si,
  _Out_ PSECURITY_DESCRIPTOR pSD,
  _In_  DWORD                cbSD,
  _Out_ LPDWORD              lpcbsdRequired
);

Параметры

lpszServer [in]

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

lpszShareName [in]

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

si [in]

Значение SECURITY_INFORMATION , указывающее сведения о безопасности, извлекаемые из дескриптора безопасности, связанного с общей папкой.

pSD [out]

Указатель на структуру SECURITY_DESCRIPTOR , получающую дескриптор безопасности. Этот параметр может принимать значение NULL. Если этот параметр имеет значение NULL, DSDM определяет размер запрошенных сведений о безопасности и возвращает необходимое количество байтов в параметре lpcbsdRequired вместе с кодом ошибки NDDE_BUF_TOO_SMALL.

cbSD [in]

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

lpcbsdRequired [out]

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

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

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

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

Требования

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

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

Обзор сетевого динамического обмена данными

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

SECURITY_INFORMATION

NDdeSetShareSecurity