NDdeShareGetInfo, fonction

Article
06/13/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 informations de partage DDE. Cette opération est généralement effectuée à des fins de modification.

Syntaxe

UINT NDdeShareGetInfo(
  _In_  LPTSTR  lpszServer,
  _In_  LPTSTR  lpszShareName,
  _In_  UINT    nLevel,
  _Out_ LPBYTE  lpBuffer,
  _In_  DWORD   cBufSize,
  _Out_ LPDWORD lpnTotalAvailable,
  _In_  LPWORD  lpnItems
);

Paramètres

lpszServer [in]: Nom du serveur sur lequel réside le DSDM.
lpszShareName [in]: Nom du partage dont les informations doivent être récupérées à partir du DSDM. Ce paramètre ne doit pas être NULL.
nLevel [in]: Niveau d’information. Ce paramètre doit être 2.
lpBuffer [out]: Pointeur vers une mémoire tampon qui reçoit la structure NDDESHAREINFO et les données associées pointées par ses membres. Ce paramètre peut être NULL. Si lpBuffer a la valeur NULL, le DSDM calcule le nombre d’octets requis pour stocker les informations de partage demandées et retourne cette valeur dans le champ lpnTotalAvailable avec l’erreur NDDE_BUF_TOO_SMALL.
cBufSize [in]: Taille de la mémoire tampon lpBuffer , en octets. Si lpBuffer a la valeur NULL, cBufSize doit être égal à zéro.
lpnTotalAvailable [out]: Pointeur vers une variable qui reçoit le nombre total d’octets nécessaires pour stocker les informations de partage demandées. Ce paramètre ne peut pas être NULL.
lpnItems [in]: Pointeur vers un masque de sélection d’élément pour la récupération partielle des informations de partage.

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	NDdeShareGetInfoW (Unicode) et NDdeShareGetInfoA (ANSI)

Voir aussi

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

Partager via