Share via


SERVICE_INFO (Windows CE 5.0)

Send Feedback

This structure contains information about a network service or a network service type.

typedef struct _SERVICE_INFO { LPGUID lpServiceType; LPTSTR lpServiceName; LPTSTR lpComment; LPTSTR lpLocale; DWORD dwDisplayHint; DWORD dwVersion; DWORD dwTime; LPTSTR lpMachineName; LPSERVICE_ADDRESSES lpServiceAddress; BLOB ServiceSpecificInfo; } SERVICE_INFO;

Members

  • lpServiceType
    Pointer to a GUID that is the type of the network service.

  • lpServiceName
    Pointer to a zero-terminated string that is the name of the network service.

  • lpComment
    Pointer to a zero-terminated string that is a comment or description for the network service, for example, Used for development upgrades.

  • lpLocale
    Pointer to a zero-terminated string that contains locale information.

  • dwDisplayHint
    Specifies a hint as to how to display the network service in a network browsing user interface. The following table shows the possible values.

    Value Description
    RESOURCEDISPLAYTYPE_DOMAIN Displays the network service as a domain.
    RESOURCEDISPLAYTYPE_FILE Displays the network service as a file.
    RESOURCEDISPLAYTYPE_GENERIC The method used to display the object does not matter.
    RESOURCEDISPLAYTYPE_GROUP Displays the network service as a group.
    RESOURCEDISPLAYTYPE_SERVER Displays the network service as a server.
    RESOURCEDISPLAYTYPE_SHARE Displays the network service as a sharepoint.
    RESOURCEDISPLAYTYPE_TREE Displays the network service as a tree.
  • dwVersion
    Version information for the network service. The high word of this value specifies a major version number. The low word of this value specifies a minor version number.

  • dwTime
    Reserved for future use. This must be set to zero.

  • lpMachineName
    Pointer to a zero-terminated string that is the name of the computer on which the network service is running.

  • lpServiceAddress
    Pointer to a SERVICE_ADDRESSES structure that contains an array of SERVICE_ADDRESS structures. Each SERVICE_ADDRESS structure contains information about a network service address.

    A network service can call the getsockname (Windows Sockets) function to determine the local address of the system.

  • ServiceSpecificInfo
    A BLOB (Windows Sockets) structure that specifies service-defined information.

    Note   In general, the data pointed to by the BLOB structure's pBlobData member must not contain any pointers. That is because only the network service knows the format of the data; copying the data without such knowledge would lead to pointer invalidation. If the data pointed to by pBlobData contains variable-sized elements, offsets from pBlobData can be used to indicate the location of those elements. The exception to this general rule occurs when pBlobData points to a SERVICE_TYPE_INFO_ABS structure. This is possible because both the SERVICE_TYPE_INFO_ABS structure, and any SERVICE_TYPE_VALUE_ABS structures it contains are predefined, and thus their formats are known to the operating system.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Winsock2.h.

See Also

BLOB (Windows Sockets) | NS_SERVICE_INFO | SERVICE_ADDRESS | SERVICE_ADDRESSES | SERVICE_TYPE_INFO_ABS | SERVICE_TYPE_VALUE_ABS

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.