Compartir a través de

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

  • Artículo

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