NDdeGetTrustedShare
The NDdeGetTrustedShare
function is called to retrieve the options associated with a DDE share that is
in the server user s list of trusted shares.
UINT NDdeGetTrustedShare(
|
LPTSTR lpszServer, |
// server to
execute on |
|
LPTSTR lpszShareName, |
// name of share to
query |
|
LPDWORD lpdwTrustOptions, |
// trust options in
effect |
|
LPDWORD lpdwShareModId0, |
// first word of
share modify identifier |
|
LPDWORD lpdwShareModId1 |
// second word of
share modify identifier |
|
); |
|
Parameters
lpszServer
Address of
the server name on which the DSDM resides.
lpszShareName
Address of
the share name whose trusted status is being queried. This parameter must not
be NULL.
lpdwTrustOptions
Address of a
variable into which the TRUST_SHARE_OPTIONS will be stored. This parameter must
not be NULL.
lpdwShareModId0
Address of a
variable into which the first word of the trusted share modify identifier will
be stored. This parameter must not be NULL.
lpdwShareModId1
Address of a
variable into which the second word of the trusted share modify identifier will
be stored. This parameter must not 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.
Remarks
The trusted
share modify identifier reflects the version of the DDE share in the DSDM at
the time the DDE share was initially granted trusted status. The trusted share
modify identifier is primarily used to purge obsolete trusted shares. However, the
user does not need to purge obsolete trusted shares. The network DDE agent
purges obsolete shares on the user s behalf.
See also
NDdeSetTrustedShare