NDdeTrustedShareEnum, fonction

Article
06/12/2023

[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.]

Récupère les noms de tous les partages DDE réseau approuvés dans le contexte du processus d’appel.

Syntaxe

UINT NDdeTrustedShareEnum(
  _In_  LPTSTR  lpszServer,
  _In_  UINT    nLevel,
  _Out_ LPBYTE  lpBuffer,
  _In_  DWORD   cBufSize,
  _Out_ LPDWORD lpnEntriesRead,
  _Out_ LPDWORD lpcbTotalAvailable
);

Paramètres

lpszServer [in]: Nom du serveur sur lequel réside le DSDM.
nLevel [in]: Réservé. Ce paramètre doit être égal à zéro.
lpBuffer [out]: Pointeur vers une mémoire tampon qui reçoit la liste des partages DDE approuvés. La liste des partages DDE approuvés est retournée sous la forme d’une séquence de chaînes séparées par des valeurs Null se terminant par un caractère null double à la fin. Ce paramètre peut être NULL. Si lpBuffer a la valeur NULL, le DSDM retourne la taille de la mémoire tampon nécessaire pour contenir la liste des partages dans le champ lpcbTotalAvailable .
cBufSize [in]: Taille de la mémoire tampon lpBuffer , en octets. Ce paramètre doit être égal à zéro si lpBuffer a la valeur NULL.
lpnEntriesRead [out]: Pointeur vers une variable qui reçoit le nombre total de partages approuvés énumérés. Ce paramètre ne peut pas être NULL.
lpcbTotalAvailable [out]: Pointeur vers une variable qui reçoit le nombre total d’octets nécessaires pour stocker la liste des partages DDE approuvés. Ce paramètre ne peut pas être NULL.

Valeur retournée

Si la fonction réussit, la valeur de retour est NDDE_NO_ERROR.

Si la fonction échoue, la valeur de retour est un code d’erreur, qui peut être traduit en message d’erreur texte en appelant NDdeGetErrorString. Si le paramètre lpBuffer a la valeur NULL, il retourne NDDE_BUF_TOO_SMALL.

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
Bibliothèque	Nddeapi.lib
DLL	Nddeapi.dll
Noms Unicode et ANSI	NDdeTrustedShareEnumW (Unicode) et NDdeTrustedShareEnumA (ANSI)

Voir aussi

Vue d’ensemble de l’échange dynamique de données réseau
Fonctions DDE réseau

Partager via