Função DdeNameService (ddeml.h)

Artigo
08/23/2023

Registra ou cancela o registro dos nomes de serviço aos quais um servidor DDE (Troca Dinâmica de Dados) dá suporte. Essa função faz com que o sistema envie transações de XTYP_REGISTER ou XTYP_UNREGISTER para outros aplicativos cliente DDEML ( Dynamic Data Exchange Management Library ) em execução.

Sintaxe

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

Parâmetros

[in] idInst

Tipo: DWORD

O identificador de instância do aplicativo obtido por uma chamada anterior para a função DdeInitialize .

[in, optional] hsz1

Tipo: HSZ

Um identificador para a cadeia de caracteres que especifica o nome do serviço que o servidor está registrando ou cancelando o registro. Um aplicativo que está cancelando o registro de todos os seus nomes de serviço deve definir esse parâmetro como 0L.

[in, optional] hsz2

Tipo: HSZ

Reservados; deve ser definido como 0L.

[in] afCmd

Tipo: UINT

As opções de nome do serviço. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
DNS_REGISTER 0x0001	Registra o nome do serviço de código de erro.
DNS_UNREGISTER 0x0002	Cancela o registro do nome do serviço de código de erro. Se o parâmetro hsz1 for 0L, todos os nomes de serviço registrados pelo servidor não serão registrados.
DNS_FILTERON 0x0004	Ativa a filtragem de inicialização de nome de serviço. O filtro impede que um servidor receba transações XTYP_CONNECT para nomes de serviço que ele não registrou. Essa é a configuração padrão para esse filtro. Se um aplicativo de servidor não registrar nenhum nome de serviço, o aplicativo não poderá receber XTYP_WILDCONNECT transações.
DNS_FILTEROFF 0x0008	Desativa a filtragem de inicialização de nome de serviço. Se esse sinalizador for especificado, o servidor receberá uma transação XTYP_CONNECT sempre que outro aplicativo DDE chamar a função DdeConnect , independentemente do nome do serviço.

Valor retornado

Tipo: HDDEDATA

Se a função for bem-sucedida, ela retornará um valor diferente de zero. Esse valor não é um valor HDDEDATA verdadeiro, apenas um indicador booliano de sucesso. A função é digitada HDDEDATA para permitir uma possível expansão futura da função e um valor retornado mais sofisticado.

Se a função falhar, o valor retornado será 0L.

A função DdeGetLastError pode ser usada para obter o código de erro, que pode ser um dos seguintes valores:

Comentários

O nome do serviço identificado pelo parâmetro hsz1 deve ser um nome base (ou seja, o nome não deve conter informações específicas da instância). O sistema gera um nome específico da instância e o envia junto com o nome base durante as transações XTYP_REGISTER e XTYP_UNREGISTER . Os aplicativos receptores podem então se conectar à instância de aplicativo específica.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ddeml.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll