estructura SERVICE_INFOA (nspapi.h)

Artículo
08/25/2023

La estructura SERVICE_INFO contiene información sobre un servicio de red o un tipo de servicio de red.

Sintaxis

typedef struct _SERVICE_INFOA {
  LPGUID              lpServiceType;
  LPSTR               lpServiceName;
  LPSTR               lpComment;
  LPSTR               lpLocale;
  DWORD               dwDisplayHint;
  DWORD               dwVersion;
  DWORD               dwTime;
  LPSTR               lpMachineName;
  LPSERVICE_ADDRESSES lpServiceAddress;
  BLOB                ServiceSpecificInfo;
} SERVICE_INFOA, *PSERVICE_INFOA, *LPSERVICE_INFOA;

Miembros

lpServiceType

Tipo: LPGUID

Puntero a un GUID que es el tipo del servicio de red.

lpServiceName

Tipo: LPTSTR

Puntero a una cadena terminada en NULL que es el nombre del servicio de red.

Si llama a la función SetService con el parámetro dwNameSpace establecido en NS_DEFAULT, el nombre del servicio de red debe ser un nombre común. Un nombre común es lo que el servicio de red se conoce normalmente como . Un ejemplo de un nombre común para un servicio de red es "Mi SQL Server".

Si llama a la función SetService con el parámetro dwNameSpace establecido en un nombre de servicio específico, el nombre del servicio de red puede ser un nombre común o un nombre distintivo. Un nombre distintivo distingue el servicio a una ubicación única con un servicio de directorio. Un ejemplo de un nombre distintivo para un servicio de red es "MS\SYS\NT\DEV\My SQL Server".

lpComment

Tipo: LPTSTR

Puntero a una cadena terminada en NULL que es un comentario o una descripción para el servicio de red. Por ejemplo, "Se usa para las actualizaciones de desarrollo".

lpLocale

Tipo: LPTSTR

Puntero a una cadena terminada en NULL que contiene información de configuración regional.

dwDisplayHint

Tipo: DWORD

Sugerencia sobre cómo mostrar el servicio de red en una interfaz de usuario de exploración de red. Puede ser uno de los valores siguientes.

Valor	Significado
RESOURCEDISPLAYTYPE_DOMAIN	Muestra el servicio de red como un dominio.
RESOURCEDISPLAYTYPE_FILE	Muestra el servicio de red como un archivo.
RESOURCEDISPLAYTYPE_GENERIC	El método utilizado para mostrar el objeto no importa.
RESOURCEDISPLAYTYPE_GROUP	Muestra el servicio de red como un grupo.
RESOURCEDISPLAYTYPE_SERVER	Muestra el servicio de red como servidor.
RESOURCEDISPLAYTYPE_SHARE	Muestra el servicio de red como un punto de conexión compartido.
RESOURCEDISPLAYTYPE_TREE	Muestra el servicio de red como un árbol.

dwVersion

Tipo: DWORD

Versión del servicio de red. La palabra alta de este valor especifica un número de versión principal. La palabra baja de este valor especifica un número de versión secundaria.

dwTime

Tipo: DWORD

Reservado para uso futuro. Debe ser cero.

lpMachineName

Tipo: LPTSTR

Puntero a una cadena terminada en NULL que es el nombre del equipo en el que se ejecuta el servicio de red.

lpServiceAddress

Tipo: LPSERVICE_ADDRESSES

Puntero a una estructura SERVICE_ADDRESSES que contiene una matriz de estructuras de SERVICE_ADDRESS . Cada estructura de SERVICE_ADDRESS contiene información sobre una dirección de servicio de red.

Un servicio de red puede llamar a la función getsockname para determinar la dirección local del sistema.

ServiceSpecificInfo

Tipo: BLOB

Estructura BLOB que especifica información definida por el servicio.

Nota En general, los datos a los que apunta el miembro pBlobData de la estructura BLOB no deben contener punteros. Esto se debe a que solo el servicio de red conoce el formato de los datos; copiar los datos sin este conocimiento provocaría una invalidación de puntero. Si los datos a los que apunta pBlobData contienen elementos de tamaño variable, se pueden usar desplazamientos de pBlobData para indicar la ubicación de esos elementos. Hay una excepción a esta regla general: cuando pBlobData apunta a una estructura de SERVICE_TYPE_INFO_ABS . Esto es posible porque tanto la estructura de SERVICE_TYPE_INFO_ABS como las estructuras de SERVICE_TYPE_VALUE_ABS que contiene están predefinidas y, por tanto, sus formatos son conocidos por el sistema operativo.

Comentarios

Nota

El encabezado nspapi.h define SERVICE_INFO como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	nspapi.h