Freigeben über


PGET_FIRST_ORDERED_SERVICE Rückruffunktion (stm.h)

Die GetFirstOrderedService-Funktion gibt den ersten Dienst in der angegebenen Reihenfolge aus der angegebenen Teilmenge der Dienste in der Tabelle zurück.

Syntax

PGET_FIRST_ORDERED_SERVICE PgetFirstOrderedService;

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

Parameter

[in] OrderingMethod

Gibt die Reihenfolge an, in der die Dienste durchsucht werden. Dieser Parameter muss einen der folgenden Werte aufweisen.

Wert Bedeutung
STM_ORDER_BY_TYPE_AND_NAME
Durchsuchen Sie die Dienste zuerst nach Typ und dann nach Name.
STM_ORDER_BY_INTERFACE_TYPE_NAME
Durchsuchen Sie die Dienste zunächst nach Schnittstellenindex, dann nach Typ und schließlich nach Name.

[in] ExclusionFlags

Gibt die Grenzwerte für den Satz der überprüften Dienste auf eine durch ExclusionFlags definierte Teilmenge und die Werte in den Membern der Struktur an, auf die der Service-Parameter verweist. Eine Beschreibung der möglichen Flags finden Sie unter CreateServiceEnumerationHandle .

[in, out] Service

Zeiger auf eine IPX_SERVICE-Struktur .

Bei der Eingabe entsprechen die Werte in den Membern den flags, die in ExclusionFlags angegeben sind.

Bei der Ausgabe der erste Dienst, der den angegebenen Kriterien entspricht.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Wert BESCHREIBUNG
ERROR_NO_MORE_ITEMS
Dienste, die den angegebenen Kriterien entsprechen, sind nicht vorhanden.
ERROR_INVALID_PARAMETER
Einer der Parameter ist ungültig.
 
 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile stm.h

Weitere Informationen

CreateServiceEnumerationHandle

IPX-Diensttabellenverwaltung

IPX_SERVICE

Diensttabellenverwaltungsfunktionen