PGET_FIRST_ORDERED_SERVICE función de devolución de llamada (stm.h)

Artículo
03/02/2024

La función GetFirstOrderedService devuelve el primer servicio en el orden especificado del subconjunto designado de servicios de la tabla.

Sintaxis

PGET_FIRST_ORDERED_SERVICE PgetFirstOrderedService;

DWORD PgetFirstOrderedService(
  [in]      DWORD OrderingMethod,
  [in]      DWORD ExclusionFlags,
  [in, out] PIPX_SERVICE Service
)
{...}

Parámetros

[in] OrderingMethod

Especifica el orden en el que se buscan los servicios. Este parámetro puede ser uno de los siguientes valores.

Value	Significado
STM_ORDER_BY_TYPE_AND_NAME	Busque primero los servicios por tipo y, a continuación, por nombre.
STM_ORDER_BY_INTERFACE_TYPE_NAME	Busque primero los servicios por índice de interfaz, luego por tipo y, por último, por nombre.

[in] ExclusionFlags

Especifica los límites del conjunto de servicios examinados a un subconjunto definido por ExclusionFlags y los valores de los miembros de la estructura a los que apunta el parámetro Service . Consulte CreateServiceEnumerationHandle para obtener una descripción de las marcas posibles.

[in, out] Service

Puntero a una estructura de IPX_SERVICE .

En la entrada, los valores de los miembros corresponden a marcas especificadas en ExclusionFlags.

En la salida, el primer servicio que coincide con los criterios especificados.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Valor	Descripción
ERROR_NO_MORE_ITEMS	Los servicios que coinciden con los criterios especificados no existen.
ERROR_INVALID_PARAMETER	Uno de los parámetros no es válido.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	stm.h

Consulte también

CreateServiceEnumerationHandle

Administración de tablas de servicio de IPX

IPX_SERVICE

Funciones de administración de tablas de servicio

Share via