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