NDdeGetShareSecurity

The NDdeGetShareSecurity function retrieves the security descriptor associated with the DDE share. This is done usually for editing.

UINT NDdeGetShareSecurity(
  LPTSTR lpszServer,        // server name
  LPTSTR lpszShareName,     // share name
  SECURITY_INFORMATION si,  // requested information
  PSECURITY_DESCRIPTOR pSD, // SD buffer
  DWORD cbSD,               // size of SD buffer
  LPDWORD lpcbsdRequired    // required size of SD buffer
);

Parameters

lpszServer

[in] Pointer to a string that specifies the name of the server on which the DSDM resides.

lpszShareName

[in] Pointer to a string that specifies the name of the share whose security descriptor is to be retrieved from the DSDM. This parameter cannot be NULL.

si

[in] A SECURITY_INFORMATION value that specifies the security information to be retrieved from the security descriptor associated with the share.

pSD

[out] Pointer to a SECURITY_DESCRIPTOR structure that receives the self-relative security descriptor. This parameter can be NULL. If this parameter is NULL, the DSDM determines the size of the requested security information and returns the number of bytes needed in the lpcbsdRequired parameter along with the NDDE_BUF_TOO_SMALL error code.

cbSD

[in] Specifies the size of the pSD buffer. This parameter must be zero if pSD is NULL.

lpcbsdRequired

[out] Pointer to the variable that receives the actual size of the retrieved security descriptor. This parameter cannot be NULL.

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. If the pSD parameter was NULL, it returns NDDE_BUF_TOO_SMALL.

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, NDdeSetShareSecurity