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 |
|