NDdeSetShareSecurity

The NDdeSetShareSecurity function sets the security descriptor associated with the DDE share. This is done usually after editing the DACL assigned to the DDE share.

UINT NDdeSetShareSecurity(
  LPTSTR lpszServer,         // server name
  LPTSTR lpszShareName,      // share name
  SECURITY_INFORMATION si,   // information type
  PSECURITY_DESCRIPTOR pSD   // security descriptor
);

Parameters

lpszServer

[in] Pointer to a string that specifies the name of the server whose DSDM is to be modified.

lpszShareName

[in] Pointer to a string that specifies 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] Pointer to a SECURITY_DESCRIPTOR structure that contains security information. This parameter cannot be NULL and should point to a valid security descriptor.

Return Values

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

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Header: Declared in Nddeapi.h.
  Library: Use Nddeapi.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT/2000.

See Also

Network Dynamic Data Exchange Overview, Network DDE Functions, SECURITY_INFORMATION, NDdeGetShareSecurity