NDdeSetTrustedShare

Overview

Group

Quick Info

Windows NT
Yes
Win95
No
Win32s
No
Import Library
nddeapi.lib
Header File
nddeapi.h
Unicode
WinNT
Platform Notes
None

The NDdeSetTrustedShare function is called to grant the referenced DDE share trusted status within the current user's context.

UINT NDdeSetTrustedShare(

Parameters
lpszServer

Address of the server name on which the DSDM will be modified.

lpszShareName

Address of the share name being granted trusted status. This parameter must not be NULL.

dwTrustOptions

Specifies the options affecting the trusted status of the DDE share. The following TRUST_SHARE_OPTIONS options are available:

Option	Meaning
NDDE_TRUST_SHARE_START	Allow the application to be started in the user's context.
NDDE_TRUST_SHARE_INIT	Allow a client to initiate to the application if it is already running in the user's context.
NDDE_TRUST_SHARE_DEL	Remove the share's trusted status.
NDDE_TRUST_CMD_SHOW	Start the application with CmdShow field defined here overriding the CmdShow specified in the DDE share DSDM.
NDDE_CMD_SHOW_MASK	CmdShow value used to override the DDE share CmdShow if the NDDE_TRUST_CMD_SHOW is set.

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 DDE share must first be created with NDdeShareAdd.

If NDdeSetTrustedShare is called with dwTrustOptions set to 0, the trusted share loses its trusted status.