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