NDdeShareEnum fonction)

[Le DDE réseau n’est plus pris en charge. Nddeapi.dll est présent sur Windows Vista, mais tous les appels de fonction renvoient NDDE _ non _ implémenté.]

Récupère la liste des partages DDE disponibles.

Syntaxe

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

Paramètres

lpszServer [ dans]

Nom du serveur sur lequel le DSDM réside.

nLevel [ dans]

Réservé. Ce paramètre doit être égal à zéro.

lpBuffer [ à]

Pointeur vers une mémoire tampon qui reçoit la liste des partages DDE. La liste des partages DDE est stockée sous la forme d’une séquence de chaînes séparées par des valeurs NULL qui se terminent 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 requise pour contenir la liste de partages dans le paramètre lpcbTotalAvailable .

cBufSize [ dans]

Taille de la mémoire tampon lpBuffer , en octets. Ce paramètre doit être égal à zéro si lpBuffer a la valeur null.

lpnEntriesRead [ à]

Pointeur vers une variable qui reçoit le nombre total de partages qui sont énumérés. Ce paramètre ne peut pas être null.

lpcbTotalAvailable [ à]

Pointeur vers une variable qui reçoit le nombre total d’octets nécessaires dans la mémoire tampon pour stocker la liste des partages DDE. Ce paramètre ne peut pas être null.

Valeur de retour

Si la fonction est réussie, la valeur de retour est NDDE _ aucune _ erreur.

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 _ trop _ petit.

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
NDdeShareEnumW (Unicode) et NDdeShareEnumA (ANSI)

Voir aussi

présentation du échange dynamique de données réseau

Fonctions DDE réseau