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

La función CreateServiceEnumerationHandle devuelve un identificador que permite el uso de funciones de enumeración rápidas y tolerantes a cambios. Estas funciones pueden examinar todos los servicios o un subconjunto especificado. Las funciones son tolerantes a cambios en que enumeran automáticamente los cambios que realizan otros procesos en el conjunto de servicios enumerados.

Sintaxis

PCREATE_SERVICE_ENUMERATION_HANDLE PcreateServiceEnumerationHandle;

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

Parámetros

[in] ExclusionFlags

Especifica los límites del conjunto de servicios que CreateServiceEnumerationHandle devuelve a un subconjunto definido por una combinación de ExclusionFlags y valores en los miembros correspondientes de CriteriaService. Este parámetro es uno de los siguientes valores.

Value Significado
STM_ONLY_THIS_INTERFACE
Enumere solo los servicios obtenidos a través de la interfaz especificada en el miembro InterfaceIndex de CriteriaService.
STM_ONLY_THIS_PROTOCOL
Enumere solo los servicios obtenidos a través del protocolo especificado en el miembro Protocol de CriteriaService. Por ejemplo, IPX_PROTOCOL_SAP para los servicios obtenidos por el protocolo DLL o IPX_PROTOCOL_STATIC para los servicios mantenidos por el administrador de enrutadores.
STM_ONLY_THIS_TYPE
Enumerar solo los servicios que tienen el mismo tipo que los del miembro service de CriteriaService

[in] CriteriaService

Puntero a una estructura IPX_SERVICE con valores de miembro que corresponden a los especificados en ExclusionFlags.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es un identificador para su uso con la función de enumeración de servicios.

Un identificador NULL indica que no existe ningún servicio con los criterios especificados o que se produjo un error en la operación. Para obtener más información, llame a GetLastError y compruebe el código de error en la tabla siguiente.

Value Descripción
ERROR_NO_SERVICES
No existen servicios con los criterios especificados.
ERROR_INVALID_PARAMETER
Uno de los parámetros no es válido.
 
 

Requisitos

   
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

CloseServiceEnumerationHandle

EnumerateGetNextService

GetLastError

Administración de tablas de servicio de IPX

IPX_SERVICE

Funciones de administración de tablas de servicio