Struttura NDDESHAREINFO

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

Contiene attributi di condivisione DDE gestiti da NetDDE Share Database Manager (DSDM). Il descrittore di sicurezza associato a ogni condivisione DDE non viene passato attraverso questa struttura ma viene eseguito l'accesso tramite funzioni specifiche. L'API NetDDE DSDM accetta questa struttura per le funzioni impostate; per le funzioni get, DSDM restituisce la struttura inserita nel buffer fornito insieme ai dati a cui fanno riferimento i membri lpszShareName, lpszAppTopicList e lpszItemList.

Sintassi

typedef struct _NDDESHAREINFO {
  LONG   lRevision;
  LPTSTR lpszShareName;
  LONG   lShareType;
  LPTSTR lpszAppTopicList;
  LONG   fSharedFlag;
  LONG   fService;
  LONG   fStartAppFlag;
  LONG   nCmdShow;
  LONG   qModifyId[2];
  LONG   cNumItems;
  LPTSTR lpszItemList;
} NDDESHAREINFO, *PNDDESHAREINFO;

Members

lRevision

Livello di revisione della struttura NDDESHAREINFO . Attualmente, il livello di revisione è 1.

lpszShareName

Nome della condivisione. Questa stringa non deve essere più di MAX_NDDESHARENAME caratteri lunghi.

lShareType

Uno o più tipi di condivisione DDE. Questo membro può essere una combinazione dei tipi di condivisione DDE supportati seguenti.

Tipo di condivisione	Significato
SHARE_TYPE_NEW 0x02	La condivisione contiene una coppia di applicazioni/argomenti OLE.
SHARE_TYPE_OLD 0x01	La condivisione contiene una coppia di applicazioni/argomenti DDE.
SHARE_TYPE_STATIC 0x04	La condivisione contiene una coppia di applicazioni/argomenti statiche.

lpszAppTopicList

Puntatore a un buffer contenente stringhe con terminazione null per le coppie DDE, OLE e statiche dell'applicazione/argomento. Il buffer deve essere nel formato seguente:

<DDE application name>|<DDE topic name>\0
<OLE application name>|<OLE topic name>\0
<static application name>|<static topic name>\0\0

fSharedFlag

Se questo membro è FALSE, la condivisione DDE non consente agli utenti remoti di comunicare tramite di esso usando DDE. Tuttavia, gli utenti locali possono comunque comunicare tramite la condivisione DDE. I collegamenti client locali sono sempre impliciti se il daCL associato concede l'accesso.

fService

Se questo membro è impostato, la condivisione DDE non verificherà se l'utente corrente lo ha impostato come attendibile prima di consentire la comunicazione DDE.

fStartAppFlag

Se questo membro è impostato e la condivisione è attendibile per avviare le applicazioni, NetDDE tenterà di avviare l'applicazione specificata da lpszAppTopicList se non è possibile avviare inizialmente una conversazione DDE con l'applicazione.

nCmdShow

Quando NetDDE avvia un'applicazione per avviare una conversazione DDE, questo valore viene inviato all'applicazione tramite il parametro nCmdShow della funzione WinMain . Definisce la modalità preferita in cui visualizzare la finestra dell'applicazione. Questo parametro è significativo solo se fStartAppFlag è attivo. L'utente connesso nel cui contesto viene avviato l'applicazione può anche eseguire l'override di questa opzione durante la promozione della condivisione allo stato attendibile. Il valore predefinito per questo membro è SW_SHOWMAXIMIZED.

qModifyId

Numero di serie a 8 byte che indica il numero di serie di modifica della condivisione DDE. Ogni volta che la condivisione DDE viene modificata da una chiamata NDdeShareSetInfo o NDdeSetShareSecurity , questi valori vengono modificati.

cNumItems

Numero di elementi elencati in lpszItemList. Se cNumItems è zero, lpszItemList è vuoto e le informazioni di condivisione e il descrittore di sicurezza associato si applicano a tutti gli elementi gestiti dall'applicazione associata.

lpszItemList

Puntatore a un buffer contenente stringhe con terminazione null che specificano gli elementi dell'applicazione client in una transazione DDE possono richiedere o avviare cicli di consulenza. Se non sono elencati elementi, la condivisione DDE consente l'uso di qualsiasi elemento. Il numero di elementi nell'elenco deve corrispondere al conteggio cNumItems .

Requisiti

Vedi anche

Panoramica di Network Dynamic Data Exchange

Strutture DDE di rete

NDdeSetShareSecurity

NDdeShareSetInfo

WinMain