PGET_FIRST_ORDERED_SERVICE fonction de rappel (stm.h)

Article
03/02/2024

La fonction GetFirstOrderedService retourne le premier service dans l’ordre spécifié à partir du sous-ensemble désigné de services dans la table.

Syntaxe

PGET_FIRST_ORDERED_SERVICE PgetFirstOrderedService;

DWORD PgetFirstOrderedService(
  [in]      DWORD OrderingMethod,
  [in]      DWORD ExclusionFlags,
  [in, out] PIPX_SERVICE Service
)
{...}

Paramètres

[in] OrderingMethod

Spécifie l’ordre dans lequel les services sont recherchés. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
STM_ORDER_BY_TYPE_AND_NAME	Recherchez d’abord les services par type, puis par nom.
STM_ORDER_BY_INTERFACE_TYPE_NAME	Recherchez d’abord les services par index d’interface, puis par type et enfin par nom.

[in] ExclusionFlags

Spécifie la limite de l’ensemble des services examinés à un sous-ensemble défini par ExclusionFlags et aux valeurs dans les membres de la structure pointés vers par le paramètre Service . Pour obtenir une description des indicateurs possibles , consultez CreateServiceEnumerationHandle .

[in, out] Service

Pointeur vers une structure IPX_SERVICE .

Lors de l’entrée, les valeurs dans les membres correspondent aux indicateurs spécifiés dans ExclusionFlags.

Sur la sortie, premier service qui correspond aux critères spécifiés.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Valeur	Description
ERROR_NO_MORE_ITEMS	Les services qui correspondent aux critères spécifiés n’existent pas.
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

CreateServiceEnumerationHandle

Gestion des tables de service IPX

IPX_SERVICE

Fonctions de gestion des tables de service

Partager via