Estructura NDDESHAREINFO

[DDE de red ya no se admite. Nddeapi.dll está presente en Windows Vista, pero todas las llamadas de función devuelven NDDE_NOT_IMPLEMENTED.]

Contiene atributos de recurso compartido de DDE mantenidos por el Administrador de bases de datos de recursos compartidos de NetDDE (DSDM). El descriptor de seguridad asociado a cada recurso compartido DDE no se pasa a través de esta estructura, pero se accede a él a través de funciones específicas. La API de DSDM de NetDDE acepta esta estructura para las funciones establecidas; para las funciones get, el DSDM devuelve la estructura empaquetada en el búfer proporcionado junto con los datos a los que hacen referencia los miembros lpszShareName, lpszAppTopicList y lpszItemList.

Sintaxis

typedef struct _NDDESHAREINFO {
  LONG   lRevision;
  LPTSTR lpszShareName;
  LONG   lShareType;
  LPTSTR lpszAppTopicList;
  LONG   fSharedFlag;
  LONG   fService;
  LONG   fStartAppFlag;
  LONG   nCmdShow;
  LONG   qModifyId[2];
  LONG   cNumItems;
  LPTSTR lpszItemList;
} NDDESHAREINFO, *PNDDESHAREINFO;

Miembros

lRevision

Nivel de revisión de la estructura NDDESHAREINFO . Actualmente, el nivel de revisión es 1.

lpszShareName

Nombre del recurso compartido. Esta cadena no debe tener más de MAX_NDDESHARENAME caracteres.

lShareType

Uno o varios tipos de recurso compartido DDE. Este miembro puede ser una combinación de los siguientes tipos de recursos compartidos DDE admitidos.

Tipo de recurso compartido	Significado
SHARE_TYPE_NEW 0x02	El recurso compartido contiene un par de temas o aplicación OLE.
SHARE_TYPE_OLD 0x01	El recurso compartido contiene un par de temas o aplicación DDE.
SHARE_TYPE_STATIC 0x04	El recurso compartido contiene un par estático de aplicaciones y temas.

lpszAppTopicList

Puntero a un búfer que contiene cadenas terminadas en NULL para los pares DDE, OLE y static application/topic. El búfer debe tener el formato siguiente:

<DDE application name>|<DDE topic name>\0
<OLE application name>|<OLE topic name>\0
<static application name>|<static topic name>\0\0

fSharedFlag

Si este miembro es FALSE, el recurso compartido DDE no permitirá a los usuarios remotos comunicarse a través de él mediante DDE. Sin embargo, los usuarios locales todavía pueden comunicarse a través del recurso compartido DDE. Los vínculos de cliente local siempre están implícitos si la DACL asociada concede acceso.

fService

Si se establece este miembro, el recurso compartido DDE no comprobará si el usuario actual lo ha establecido como de confianza antes de permitir la comunicación DDE.

fStartAppFlag

Si se establece este miembro y el recurso compartido es de confianza para iniciar aplicaciones, NetDDE intentará iniciar la aplicación especificada por lpszAppTopicList si no puede iniciar inicialmente una conversación DDE con la aplicación.

nCmdShow

Cuando NetDDE inicia una aplicación para iniciar una conversación DDE, este valor se envía a la aplicación a través del parámetro nCmdShow de la función WinMain . Define el modo preferido en el que se mostrará la ventana de la aplicación. Este parámetro solo es significativo si fStartAppFlag está activo. El usuario que ha iniciado sesión en cuyo contexto se inicia la aplicación también puede invalidar esta opción al promover el recurso compartido al estado de confianza. El valor predeterminado para este miembro es SW_SHOWMAXIMIZED.

qModifyId

Número de serie de 8 bytes que indica el número de serie de modificación del recurso compartido DDE. Cada vez que el recurso compartido DDE se modifica mediante una llamada NDdeShareSetInfo o NDdeSetShareSecurity , estos valores se cambian.

cNumItems

Número de elementos enumerados en lpszItemList. Si cNumItems es cero, lpszItemList está vacío y la información de recurso compartido y el descriptor de seguridad asociado se aplican a todos los elementos que proporciona la aplicación asociada.

lpszItemList

Puntero a un búfer que contiene cadenas terminadas en NULL que especifican los elementos en los que la aplicación cliente de una transacción DDE puede solicitar o iniciar bucles de aviso. Si no se muestran elementos, el recurso compartido DDE permite usar cualquier elemento. El número de elementos de la lista debe coincidir con el número de cNumItems .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Nddeapi.h

Consulte también

Información general sobre intercambio dinámico de datos de red

Estructuras de DDE de red

NDdeSetShareSecurity

NDdeShareSetInfo

WinMain