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

Artigo
03/09/2024

A função CreateServiceEnumerationHandle retorna um identificador que permite o uso de funções de enumeração rápidas e tolerantes a alterações. Essas funções podem examinar todos os serviços ou um subconjunto especificado. As funções são tolerantes a alterações, pois enumeram automaticamente quaisquer alterações feitas por outros processos no conjunto de serviços enumerados

Sintaxe

PCREATE_SERVICE_ENUMERATION_HANDLE PcreateServiceEnumerationHandle;

HANDLE PcreateServiceEnumerationHandle(
  [in] DWORD ExclusionFlags,
  [in] PIPX_SERVICE CriteriaService
)
{...}

Parâmetros

[in] ExclusionFlags

Especifica os limites do conjunto de serviços que CreateServiceEnumerationHandle retorna a um subconjunto definido por uma combinação de ExclusionFlags e valores nos membros correspondentes de CriteriaService. Esse parâmetro é um dos valores a seguir.

Valor	Significado
STM_ONLY_THIS_INTERFACE	Enumerar somente os serviços que foram obtidos por meio da interface especificada no membro InterfaceIndex de CriteriaService.
STM_ONLY_THIS_PROTOCOL	Enumerar somente os serviços que foram obtidos por meio do protocolo especificado no membro Protocol de CriteriaService. Por exemplo, IPX_PROTOCOL_SAP para serviços obtidos pelo protocolo DLL ou IPX_PROTOCOL_STATIC para serviços mantidos pelo gerenciador de roteadores.
STM_ONLY_THIS_TYPE	Enumerar somente os serviços que têm o mesmo tipo que os membros do Serviço de CriteriaService

[in] CriteriaService

Ponteiro para uma estrutura IPX_SERVICE com valores de membro que correspondem aos especificados em ExclusionFlags.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador para uso com a função de enumeração de serviço.

Um identificador NULL indica que não existem serviços com os critérios especificados ou que a operação falhou. Para obter mais informações, chame GetLastError e marcar o código de erro na tabela abaixo.

Valor	Descrição
ERROR_NO_SERVICES	Nenhum serviço existe com os critérios especificados.
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