Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The getservbyname and getservbyport functions use the WSALookupServiceBegin function to query SVCID_INET_SERVICEBYNAME as the service class GUID. The lpszServiceInstanceName member in the WSAQUERYSET structure passed to the WSALookupServiceBegin function references a string to indicate the service name or service port, and (optionally) the service protocol. The formatting of the string is illustrated as FTP or TCP or 21/TCP or just FTP. The string is not case sensitive. The slash mark, if present, separates the protocol identifier from the preceding part of the string. The Ws2_32.dll will specify LUP_RETURN_BLOB and the namespace provider will place a SERVENT structure in the blob (using offsets instead of pointers as described above). Namespace providers should honor these other LUP_RETURN_* flags as well.
| Flag | Description |
|---|---|
| LUP_RETURN_NAME | Returns the s_name member from SERVENT structure in lpszServiceInstanceName. |
| LUP_RETURN_TYPE | Returns canonical GUID in lpServiceClassId It is understood that a service identified as FTP or 21 may be on another port according to locally established conventions. The s_port parameter of the SERVENT structure should indicate where the service can be contacted in the local environment. The canonical GUID returned when LUP_RETURN_TYPE is set should be one of the predefined GUIDs from Svcs.h that corresponds to the port number indicated in the SERVENT structure. |
Related topics