Fonction NDdeShareEnum
[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.
UINT NDdeShareEnum(
_In_ LPTSTR lpszServer,
_In_ UINT nLevel,
_Out_ LPBYTE lpBuffer,
_In_ DWORD cBufSize,
_Out_ LPDWORD lpnEntriesRead,
_Out_ LPDWORD lpcbTotalAvailable
);
-
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.
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.
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 |
|
Bibliothèque |
|
DLL |
|
Noms Unicode et ANSI |
NDdeShareEnumW (Unicode) et NDdeShareEnumA (ANSI) |