Nazwa usługi

Biblioteka dynamicznego zarządzania wymianą danych (DDEML) umożliwia aplikacji serwera zarejestrowanie obsługiwanych przez nią nazw usług i uniemożliwienie DDEML wysyłania transakcji XTYP_CONNECT dla nieobsługiwanych nazw usług do funkcji dynamicznej wymiany danych (DDE) serwera.

W poniższych tematach opisano usługę nazw.

• rejestracji nazw usług
• filtr nazwy usługi

Rejestracja nazwy usługi

Rejestrując nazwy swoich usług w DDEML, serwer informuje inne aplikacje DDE w systemie, że jest dostępny nowy serwer. Serwer rejestruje nazwę usługi, wywołując funkcję DdeNameService i określając uchwyt ciągu identyfikujący nazwę. W odpowiedzi DDEML wysyła transakcję XTYP_REGISTER do funkcji wywołania zwrotnego każdej aplikacji DDEML w systemie (z wyjątkiem tych, które określiły flagę filtru CBF_SKIP_REGISTRATIONS w funkcji Ddetialize). Transakcja XTYP_REGISTER przekazuje dwa dojścia ciągu do funkcji wywołania zwrotnego: pierwszy identyfikuje ciąg określający nazwę usługi podstawowej, a drugi identyfikuje ciąg określający usługę specyficzną dla wystąpienia. Klient zazwyczaj używa podstawowej nazwy usługi na liście dostępnych serwerów, więc użytkownik może wybrać serwer z listy. Klient używa nazwy usługi specyficznej dla wystąpienia do nawiązania rozmowy z określonym wystąpieniem aplikacji serwera, jeśli jest uruchomione więcej niż jedno wystąpienie.

Serwer może użyć DdeNameService do wyrejestrowania nazwy usługi. Ta funkcja powoduje, że DDEML wysyła XTYP_UNREGISTER transakcji do innych aplikacji DDE w systemie, informując ich, że nie mogą już używać nazwy do nawiązywania konwersacji.

Serwer musi wywołać DdeNameService, aby zarejestrować nazwy swoich usług wkrótce po wywołaniu DdeInitialize. Serwer musi wyrejestrować nazwy usług przy użyciu DdeNameService tuż przed wywołaniem funkcji DdeUninitialize.

Filtr nazwy usługi

Oprócz rejestrowania nazw usług DdeNameService umożliwia serwerowi włączenie lub wyłączenie filtru nazwy usługi. Gdy serwer wyłączy filtr nazwy usługi, DDEML wysyła transakcję XTYP_CONNECT do funkcji wywołania zwrotnego DDE serwera za każdym razem, gdy każdy klient wywołuje funkcję DdeConnect, niezależnie od nazwy usługi określonej w funkcji. Gdy serwer włączy filtr nazwy usługi, DDEML wysyła transakcję XTYP_CONNECT do serwera tylko wtedy, gdy DdeConnect określa nazwę usługi, która serwer określił w wywołaniu DdeNameService.

Domyślnie filtr nazwy usługi jest włączony, gdy aplikacja wywołuje DdeInitialize. To ustawienie domyślne uniemożliwia DDEML wysyłanie transakcji XTYP_CONNECT do serwera, zanim serwer utworzył ciąg, który go potrzebuje. Serwer może wyłączyć filtr nazwy usługi, określając flagę DNS_FILTEROFF w wywołaniu DdeNameService. Flaga DNS_FILTERON włącza filtr.