NDdeSetShareSecurity function
[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 |
|
| Library |
|
| DLL |
|
| Unicode and ANSI names |
NDdeSetShareSecurityW (Unicode) and NDdeSetShareSecurityA (ANSI) |