SERVICE_INFO (Compact 2013)

Artigo
11/04/2015

3/26/2014

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

Syntax

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 share.
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; set to 0 (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 OS.

Requirements

Header

winsock2.h

Compartilhar via

SERVICE_INFO (Compact 2013)

Syntax

Members

Requirements

See Also

Reference

Recursos adicionais