Функция NDdeGetShareSecurity

Статья
06/13/2023

[Сетевое 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

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