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

  • Artículo

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 valores siguientes.

Valor Significado
STM_ONLY_THIS_INTERFACE
 Enumere solo los servicios que se obtuvieron a través de la interfaz especificada en el miembro InterfaceIndex de CriteriaService.
STM_ONLY_THIS_PROTOCOL
 Enumere solo los servicios que se obtuvieron 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
 Enumere solo los servicios que tengan el mismo tipo que los del miembro service de CriteriaService.

[in] CriteriaService

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

Valor devuelto

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

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.

Valor 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

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

CloseServiceEnumerationHandle

EnumerateGetNextService

Obtener último error

Administración de tablas de servicio DE IPX

IPX_SERVICE

Funciones de administración de tablas de servicio