Funzione DdeNameService (ddeml.h)

Articolo
08/23/2023

Registra o annulla la registrazione dei nomi dei servizi supportati da un server DDE (Dynamic Data Exchange). Questa funzione causa l'invio di XTYP_REGISTER o XTYP_UNREGISTER transazioni ad altre applicazioni client DDEML ( Dynamic Data Exchange Management Library ).

Sintassi

HDDEDATA DdeNameService(
  [in]           DWORD idInst,
  [in, optional] HSZ   hsz1,
  [in, optional] HSZ   hsz2,
  [in]           UINT  afCmd
);

Parametri

[in] idInst

Tipo: DWORD

Identificatore dell'istanza dell'applicazione ottenuto da una chiamata precedente alla funzione DdeInitialize .

[in, optional] hsz1

Tipo: HSZ

Handle alla stringa che specifica il nome del servizio che il server sta registrando o annullando la registrazione. Un'applicazione che annulla la registrazione di tutti i relativi nomi di servizio deve impostare questo parametro su 0L.

[in, optional] hsz2

Tipo: HSZ

Riservati; deve essere impostato su 0L.

[in] afCmd

Tipo: UINT

Opzioni del nome del servizio. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
DNS_REGISTER 0x0001	Registra il nome del servizio codice di errore.
DNS_UNREGISTER 0x0002	Annulla la registrazione del nome del servizio del codice di errore. Se il parametro hsz1 è 0L, tutti i nomi di servizio registrati dal server verranno annullati.
DNS_FILTERON 0x0004	Attiva il filtro di avvio dei nomi del servizio. Il filtro impedisce a un server di ricevere transazioni XTYP_CONNECT per i nomi dei servizi non registrati. Questa è l'impostazione predefinita per questo filtro. Se un'applicazione server non registra nomi di servizio, l'applicazione non può ricevere transazioni XTYP_WILDCONNECT .
DNS_FILTEROFF 0x0008	Disattiva il filtro di avvio dei nomi del servizio. Se questo flag viene specificato, il server riceve una transazione XTYP_CONNECT ogni volta che un'altra applicazione DDE chiama la funzione DdeConnect , indipendentemente dal nome del servizio.

Valore restituito

Tipo: HDDEDATA

Se la funzione ha esito positivo, restituisce un valore diverso da zero. Questo valore non è un vero valore HDDEDATA , semplicemente un indicatore booleano dell'esito positivo. La funzione è tipizzata HDDEDATA per consentire l'espansione futura della funzione e un valore restituito più sofisticato.

Se la funzione ha esito negativo, il valore restituito è 0L.

La funzione DdeGetLastError può essere usata per ottenere il codice di errore, che può essere uno dei valori seguenti:

Commenti

Il nome del servizio identificato dal parametro hsz1 deve essere un nome di base, ovvero il nome non deve contenere informazioni specifiche dell'istanza. Il sistema genera un nome specifico dell'istanza e lo invia insieme al nome di base durante le transazioni di XTYP_REGISTER e XTYP_UNREGISTER . Le applicazioni di ricezione possono quindi connettersi all'istanza dell'applicazione specifica.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ddeml.h (includere Windows.h)
Libreria	User32.lib
DLL	User32.dll