The SERVICE_INFO 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;
If you are calling the SetService function with the dwNameSpace parameter set to NS_DEFAULT, the network service name must be a common name. A common name is what the network service is commonly known as. An example of a common name for a network service is "My SQL Server".
If you are calling the SetService function with the dwNameSpace parameter set to a specific service name, the network service name can be a common name or a distinguished name. A distinguished name distinguishes the service to a unique location with a directory service. An example of a distinguished name for a network service is "MS\\SYS\\NT\\DEV\\My SQL Server".
Value | Meaning |
---|---|
RESOURCEDISPLAYTYPE_DOMAIN | Display the network service as a domain. |
RESOURCEDISPLAYTYPE_FILE | Display the network service as a file. |
RESOURCEDISPLAYTYPE_GENERIC | The method used to display the object does not matter. |
RESOURCEDISPLAYTYPE_GROUP | Display the network service as a group. |
RESOURCEDISPLAYTYPE_SERVER | Display the network service as a server. |
RESOURCEDISPLAYTYPE_SHARE | Display the network service as a sharepoint. |
RESOURCEDISPLAYTYPE_TREE | Display the network service as a tree. |
A network service can call the getsockname function to determine the local address of the system.
Note that, 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. There is one exception to this general rule: 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.
Windows NT: Yes
Windows CE: Unsupported.
Header: Declared in nspapi.h.
BLOB, GetService, NS_SERVICE_INFO, SetService, SERVICE_ADDRESS, SERVICE_ADDRESSES, SERVICE_TYPE_INFO_ABS, SERVICE_TYPE_VALUE_ABS