Dienst Abfrage

Eine Name Service-Abfrage umfasst eine Reihe von aufrufen: nsplookupservicebegin, gefolgt von einem oder mehreren Aufrufen von nsplookupservicenext und endet mit einem Aufruf von nsplookupserviceend. Nsplookupservicebegin nimmt eine wsaqueryset -Struktur als Eingabe an, um die Abfrage Parameter zusammen mit einem Satz von Flags zu definieren, um eine zusätzliche Kontrolle über den Suchvorgang bereitzustellen. Es wird ein Abfrage Handle zurückgegeben, das in den nachfolgenden Aufrufen von nsplookupservicenext und nsplookupserviceend verwendet wird.

Der-Namespace-SPI-Client ruft nsplookupservicenext auf, um Abfrageergebnisse abzurufen, wobei Ergebnisse in einem vom Client bereitgestellten wsaqueryset -Puffer bereitgestellt werden. Der Client ruft weiterhin nsplookupservicenext auf, bis der Fehlercode WSA _ E _ nicht _ mehr zurückgegeben wird, was darauf hinweist, dass alle Ergebnisse abgerufen wurden. Die Suche wird dann durch einen nsplookupserviceend-Befehl beendet. Die nsplookupserviceend -Funktion kann auch verwendet werden, um einen aktuell ausstehenden nsplookupservicenext abzubrechen, wenn er von einem anderen Thread aufgerufen wird.

In Windows Sockets 2 werden widersprüchliche Fehlercodes für wsaumomore (10102) und WSA _ E _ nicht _ mehr (10110) definiert. Der Fehlercode wsaeromore wird in einer zukünftigen Version entfernt, und nur WSA _ E _ _ bleibt erhalten. Namespace Anbieter sollten so bald wie möglich auf die Verwendung des WSA _ E- _ _ Fehlercodes umstellen, um die Kompatibilität mit der größtmöglichen Anzahl von Anwendungen aufrechtzuerhalten.