Structure NDDESHAREINFO

[Le DDE réseau n’est plus pris en charge. Nddeapi.dll est présent sur Windows Vista, mais tous les appels de fonction retournent NDDE_NOT_IMPLEMENTED.]

Contient les attributs de partage DDE gérés par netDDE Share Database Manager (DSDM). Le descripteur de sécurité associé à chaque partage DDE n’est pas transmis via cette structure, mais est accessible via des fonctions spécifiques. L’API DSDM NetDDE accepte cette structure pour les fonctions set ; pour les fonctions get, le DSDM retourne la structure empaquetée dans la mémoire tampon fournie, ainsi que les données référencées par les membres lpszShareName, lpszAppTopicList et lpszItemList.

Syntaxe

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;

Membres

lRevision

Niveau de révision de la structure NDDESHAREINFO . Actuellement, le niveau de révision est 1.

lpszShareName

Nom du partage. Cette chaîne ne doit pas comporter plus de MAX_NDDESHARENAME caractères.

lShareType

Un ou plusieurs types de partage DDE. Ce membre peut être une combinaison des types de partage DDE pris en charge suivants.

Type de partage	Signification
SHARE_TYPE_NEW 0x02	Le partage contient une paire application/rubrique OLE.
SHARE_TYPE_OLD 0x01	Le partage contient une paire application/rubrique DDE.
SHARE_TYPE_STATIC 0x04	Le partage contient une paire application/rubrique statique.

lpszAppTopicList

Pointeur vers une mémoire tampon contenant des chaînes terminées par null pour les paires DDE, OLE et application/rubrique statique. La mémoire tampon doit être au format suivant :

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

fSharedFlag

Si ce membre a la valeur FALSE, le partage DDE n’autorisera pas les utilisateurs distants à communiquer via celui-ci à l’aide de DDE. Toutefois, les utilisateurs locaux peuvent toujours communiquer via le partage DDE. Les liens de client local sont toujours implicites si la liste de contrôle d’accès associée accorde l’accès.

fService

Si ce membre est défini, le partage DDE ne case activée pas si l’utilisateur actuel l’a défini comme approuvé avant d’autoriser la communication DDE.

fStartAppFlag

Si ce membre est défini et que le partage est approuvé pour démarrer les applications, NetDDE tente de démarrer l’application spécifiée par lpszAppTopicList s’il ne peut pas démarrer une conversation DDE avec l’application.

nCmdShow

Lorsque NetDDE démarre une application pour lancer une conversation DDE, cette valeur est envoyée à l’application via le paramètre nCmdShow de la fonction WinMain . Il définit le mode préféré pour la fenêtre d’application à afficher dans. Ce paramètre est significatif uniquement si fStartAppFlag est actif. L’utilisateur connecté dans lequel l’application est démarrée peut également remplacer cette option lors de la promotion du partage vers des status approuvés. La valeur par défaut de ce membre est SW_SHOWMAXIMIZED.

qModifyId

Numéro de série de 8 octets qui indique le numéro de série de modification du partage DDE. Chaque fois que le partage DDE est modifié par un appel NDdeShareSetInfo ou NDdeSetShareSecurity , ces valeurs sont modifiées.

cNumItems

Nombre d’éléments répertoriés dans lpszItemList. Si cNumItems est égal à zéro, lpszItemList est vide, et les informations de partage et le descripteur de sécurité associé s’appliquent à tous les éléments dont la maintenance est effectuée par l’application associée.

lpszItemList

Pointeur vers une mémoire tampon contenant des chaînes terminées par null qui spécifient les éléments que l’application cliente dans une transaction DDE peut demander ou démarrer des boucles de conseil. Si aucun élément n’est répertorié, le partage DDE autorise l’utilisation de n’importe quel élément. Le nombre d’éléments de la liste doit correspondre au nombre cNumItems .

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Nddeapi.h

Voir aussi

Vue d’ensemble de l’échange de données dynamiques réseau

Structures DDE réseau

NDdeSetShareSecurity

NDdeShareSetInfo

WinMain