NDdeShareAdd
The NDdeShareAdd
function is called to create and add a new DDE share to the DDE Share Database
Manager (DSDM).
UINT NDdeShareAdd(
|
LPTSTR lpszServer, |
// server to
execute on |
|
UINT nLevel, |
// info level must
be 2 |
|
PSECURITY_DESCRIPTOR pSD, |
// initial security
descriptor |
|
LPBYTE lpBuffer, |
// address of
NDDESHAREINFO |
|
DWORD cBufSize |
// size of supplied
buffer |
|
); |
|
Parameters
lpszServer
Address of
the server name on which the DSDM will be modified.
nLevel
Must always
be 2.
pSD
Address of
the SECURITY_DESCRIPTOR
that will be associated with this share and against which access checks will be
performed on subsequent initiates to this share. This parameter can optionally
be NULL, in which case the DSDM creates a default SECURITY_DESCRIPTOR
that grants Full Control to the CREATOR_OWNER and Read and Link to
everyone.
lpBuffer
Address of
the NDDESHAREINFO
structure that defines the ApplicationTopic list associated with the DDE share
being created as well as other parameters. This parameter must not be NULL.
cBufSize
Size of the
structure identified by lpBuffer. This parameter must not be 0.
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
Before a
client can connect to the DDE share, it must be trusted with NDdeSetTrustedShare.
See Also