PGET_FIRST_ORDERED_SERVICE função de retorno de chamada (stm.h)

Artigo
08/26/2023

A função GetFirstOrderedService retorna o primeiro serviço na ordem especificada do subconjunto designado de serviços na tabela.

Sintaxe

PGET_FIRST_ORDERED_SERVICE PgetFirstOrderedService;

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

Parâmetros

[in] OrderingMethod

Especifica a ordem na qual os serviços são pesquisados. Esse parâmetro deve usar um dos valores a seguir.

Valor	Significado
STM_ORDER_BY_TYPE_AND_NAME	Pesquise os serviços primeiro por tipo e depois por nome.
STM_ORDER_BY_INTERFACE_TYPE_NAME	Pesquise os serviços primeiro por índice de interface, depois por tipo e, finalmente, por nome.

[in] ExclusionFlags

Especifica os limites do conjunto de serviços examinados a um subconjunto definido por ExclusionFlags e os valores nos membros da estrutura apontada pelo parâmetro Service . Consulte CreateServiceEnumerationHandle para obter uma descrição dos possíveis sinalizadores.

[in, out] Service

Ponteiro para uma estrutura IPX_SERVICE .

Na entrada, os valores nos membros correspondem aos sinalizadores especificados em ExclusionFlags.

Na saída, o primeiro serviço que corresponde aos critérios especificados.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos códigos de erro a seguir.

Valor	Descrição
ERROR_NO_MORE_ITEMS	Os serviços que correspondem aos critérios especificados não existem.
ERROR_INVALID_PARAMETER	Um dos parâmetros é inválido.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	stm.h

Confira também

CreateServiceEnumerationHandle

Gerenciamento de Tabela de Serviço IPX

IPX_SERVICE

Funções de gerenciamento de tabela de serviço

Compartilhar via