Función DdeNameService (ddeml.h)

Artículo
08/23/2023

Registra o anula el registro de los nombres de servicio que admite un servidor de Intercambio dinámico de datos (DDE). Esta función hace que el sistema envíe XTYP_REGISTER o XTYP_UNREGISTER transacciones a otras aplicaciones cliente de la Biblioteca de administración dinámica de Exchange de datos (DDEML).

Sintaxis

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

Parámetros

[in] idInst

Tipo: DWORD

Identificador de instancia de aplicación obtenido por una llamada anterior a la función DdeInitialize .

[in, optional] hsz1

Tipo: HSZ

Identificador de la cadena que especifica el nombre de servicio que el servidor está registrando o anulando el registro. Una aplicación que anule el registro de todos sus nombres de servicio debe establecer este parámetro en 0L.

[in, optional] hsz2

Tipo: HSZ

Reservados; debe establecerse en 0L.

[in] afCmd

Tipo: UINT

Opciones de nombre de servicio. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
DNS_REGISTER 0x0001	Registra el nombre del servicio de código de error.
DNS_UNREGISTER 0x0002	Anula el registro del nombre del servicio de código de error. Si el parámetro hsz1 es 0L, se anularán el registro de todos los nombres de servicio registrados por el servidor.
DNS_FILTERON 0x0004	Activa el filtrado de inicio del nombre del servicio. El filtro impide que un servidor reciba transacciones XTYP_CONNECT para los nombres de servicio que no ha registrado. Esta es la configuración predeterminada para este filtro. Si una aplicación de servidor no registra ningún nombre de servicio, la aplicación no puede recibir XTYP_WILDCONNECT transacciones.
DNS_FILTEROFF 0x0008	Desactiva el filtrado de inicio del nombre del servicio. Si se especifica esta marca, el servidor recibe una transacción XTYP_CONNECT cada vez que otra aplicación DDE llama a la función DdeConnect , independientemente del nombre del servicio.

Valor devuelto

Tipo: HDDEDATA

Si la función se realiza correctamente, devuelve un valor distinto de cero. Ese valor no es un valor HDDEDATA verdadero, simplemente un indicador booleano de éxito. La función tiene el tipo HDDEDATA para permitir una posible expansión futura de la función y un valor devuelto más sofisticado.

Si se produce un error en la función, el valor devuelto es 0L.

La función DdeGetLastError se puede usar para obtener el código de error, que puede ser uno de los siguientes valores:

Comentarios

El nombre del servicio identificado por el parámetro hsz1 debe ser un nombre base (es decir, el nombre no debe contener información específica de la instancia). El sistema genera un nombre específico de la instancia y lo envía junto con el nombre base durante las transacciones de XTYP_REGISTER y XTYP_UNREGISTER . Después, las aplicaciones receptoras se pueden conectar a la instancia de aplicación específica.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ddeml.h (incluye Windows.h)
Library	User32.lib
Archivo DLL	User32.dll