Funzione NDdeShareGetInfo

Articolo
06/13/2023

[Network DDE non è più supportato. Nddeapi.dll è presente in Windows Vista, ma tutte le chiamate di funzione restituiscono NDDE_NOT_IMPLEMENTED.]

Recupera le informazioni di condivisione DDE. Questa operazione viene in genere eseguita per la modifica.

Sintassi

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

Parametri

lpszServer [in]: Nome del server in cui risiede il DSDM.
lpszShareName [in]: Nome della condivisione le cui informazioni devono essere recuperate dal DSDM. Questo parametro non deve essere NULL.
nLevel [in]: Livello informativo. Questo parametro deve essere 2.
lpBuffer [out]: Puntatore a un buffer che riceve la struttura NDDESHAREINFO e i dati associati a cui puntano i membri. Questo parametro può essere NULL. Se lpBuffer è NULL, DSDM calcola il numero di byte necessari per archiviare le informazioni di condivisione richieste e restituisce tale valore nel campo lpnTotalAvailable insieme all'errore NDDE_BUF_TOO_SMALL.
cBufSize [in]: Dimensioni del buffer lpBuffer , in byte. Se lpBuffer è NULL, cBufSize deve essere zero.
lpnTotalAvailable [out]: Puntatore a una variabile che riceve il numero totale di byte necessari per archiviare le informazioni di condivisione richieste. Questo parametro non può essere NULL.
lpnItems [in]: Puntatore a una maschera di selezione dell'elemento per il recupero parziale delle informazioni di condivisione.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NDDE_NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è un codice di errore, che può essere convertito in un messaggio di errore di testo chiamando NDdeGetErrorString. Se il parametro lpBuffer è NULL, restituisce NDDE_BUF_TOO_SMALL.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Nddeapi.h
Libreria	Nddeapi.lib
DLL	Nddeapi.dll
Nomi Unicode e ANSI	NDdeShareGetInfoW (Unicode) e NDdeShareGetInfoA (ANSI)

Vedi anche

Panoramica di Network Dynamic Data Exchange
Funzioni DDE di rete
NDDESHAREINFO
NDdeShareSetInfo

Condividi tramite