NDdeSetShareSecurity function

Article
01/07/2021

[Network DDE is no longer supported. Nddeapi.dll is present on Windows Vista, but all function calls return NDDE_NOT_IMPLEMENTED.]

Sets the security descriptor associated with the DDE share. This is done usually after editing the DACL assigned to the DDE share.

Syntax

UINT NDdeSetShareSecurity(
  _In_ LPTSTR               lpszServer,
  _In_ LPTSTR               lpszShareName,
  _In_ SECURITY_INFORMATION si,
  _In_ PSECURITY_DESCRIPTOR pSD
);

Parameters

lpszServer [in]: The name of the server whose DSDM is to be modified.
lpszShareName [in]: The name of the share whose security descriptor is to be modified. This parameter cannot be NULL.
si [in]: A SECURITY_INFORMATION value that identifies the security information to retrieve.
pSD [in]: A pointer to a SECURITY_DESCRIPTOR structure that contains security information. This parameter cannot be NULL and should point to a valid security descriptor.

Return value

If the function succeeds, the return value is NDDE_NO_ERROR.

If the function fails, the return value is an error code, which can be translated into a text error message by calling NDdeGetErrorString.

Remarks

To modify the SECURITY_DESCRIPTOR associated with a DDE share in the DSDM, the user must have appropriate privilege; the share creator has this privilege.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Nddeapi.h
Library	Nddeapi.lib
DLL	Nddeapi.dll
Unicode and ANSI names	NDdeSetShareSecurityW (Unicode) and NDdeSetShareSecurityA (ANSI)