PCREATE_SERVICE_ENUMERATION_HANDLE fonction de rappel (stm.h)

La fonction CreateServiceEnumerationHandle retourne un handle qui permet d’utiliser des fonctions d’énumération rapides et tolérantes aux changements. Ces fonctions peuvent analyser tous les services ou un sous-ensemble spécifié. Les fonctions sont tolérantes aux changements, car elles énumèrent automatiquement toutes les modifications apportées par d’autres processus à l’ensemble des services énumérés

Syntaxe

PCREATE_SERVICE_ENUMERATION_HANDLE PcreateServiceEnumerationHandle;

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

Paramètres

[in] ExclusionFlags

Spécifie les limites de l’ensemble de services que CreateServiceEnumerationHandle retourne à un sous-ensemble défini par une combinaison d’ExclusionFlags et de valeurs dans les membres correspondants de CriteriaService. Ce paramètre est l’une des valeurs suivantes.

Valeur	Signification
STM_ONLY_THIS_INTERFACE	Énumérez uniquement les services obtenus via l’interface spécifiée dans le membre InterfaceIndex de CriteriaService.
STM_ONLY_THIS_PROTOCOL	Énumérez uniquement les services obtenus via le protocole spécifié dans le membre protocole de CriteriaService. Par exemple, IPX_PROTOCOL_SAP pour les services obtenus par le protocole DLL ou IPX_PROTOCOL_STATIC pour les services gérés par le gestionnaire de routeur.
STM_ONLY_THIS_TYPE	Énumérer uniquement les services qui ont le même type que ceux du membre de service de CriteriaService

[in] CriteriaService

Pointeur vers une structure IPX_SERVICE avec des valeurs membres qui correspondent à celles spécifiées dans ExclusionFlags.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle à utiliser avec la fonction d’énumération de service.

Un handle NULL indique qu’il n’existe aucun service avec les critères spécifiés ou que l’opération a échoué. Pour plus d’informations, appelez GetLastError et case activée le code d’erreur dans le tableau ci-dessous.

Valeur	Description
ERROR_NO_SERVICES	Aucun service n’existe avec les critères spécifiés.
ERROR_INVALID_PARAMETER	L’un des paramètres n’est pas valide.

 

 

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	stm.h

Voir aussi

CloseServiceEnumerationHandle

EnumerateGetNextService

Obtenir la dernière erreur

Gestion des tables de service IPX

IPX_SERVICE

Fonctions de gestion des tables de service