Fonction NDdeShareEnum

  • Article

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

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 [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. La liste des partages DDE est stockée sous la forme d’une séquence de chaînes séparées par un double caractère null à la fin. Ce paramètre peut être NULL. Si lpBuffer a la valeur NULL, le DSDM retourne la taille de mémoire tampon requise pour contenir la liste des partages dans le paramètre 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 énumérés. Ce paramètre ne peut pas avoir la valeur NULL.

lpcbTotalAvailable [out]

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

Voir aussi

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

Fonctions DDE réseau