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

Artigo
03/02/2024

A função EnumerateGetNextService retorna a próxima entrada de serviço em uma enumeração iniciada por CreateServiceEnumerationHandle.

Sintaxe

PENUMERATE_GET_NEXT_SERVICE PenumerateGetNextService;

DWORD PenumerateGetNextService(
  [in]  HANDLE EnumerationHandle,
  [out] PIPX_SERVICE Service
)
{...}

Parâmetros

[in] EnumerationHandle

Identificador que identifica a enumeração e especifica o subconjunto de serviços nos quais a enumeração funcionará. O identificador é obtido de uma chamada para CreateServiceEnumerationHandle.

[out] Service

Ponteiro para uma estrutura IPX_SERVICE que contém o próximo serviço na enumeração. Os serviços são retornados em nenhuma ordem específica e cada serviço no subconjunto é retornado apenas uma vez.

Retornar valor

Se a função for bem-sucedida, o buffer apontado pelo parâmetro Service receberá o próximo serviço na enumeração. Nesse caso, o valor retornado é NO_ERROR.

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

Valor	Descrição
ERROR_NO_MORE_ITEMS	Não existem mais serviços com os critérios especificados.
ERROR_CAN_NOT_COMPLETE	Falha na operação.

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 tabelas de serviço IPX

IPX_SERVICE

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

Compartilhar via