Freigeben über

PCREATE_SERVICE_ENUMERATION_HANDLE Rückruffunktion (stm.h)

Die CreateServiceEnumerationHandle-Funktion gibt ein Handle zurück, das die Verwendung von schnellen und änderungstoleranten Enumerationsfunktionen ermöglicht. Solche Funktionen können alle Dienste oder eine angegebene Teilmenge durchsuchen. Die Funktionen sind änderungstolerant, da sie automatisch alle Änderungen auflisten, die andere Prozesse an der Gruppe der aufgezählten Dienste vornehmen.

Syntax

PCREATE_SERVICE_ENUMERATION_HANDLE PcreateServiceEnumerationHandle;

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

Parameter

[in] ExclusionFlags

Gibt die Grenzwerte für den Satz von Diensten an, die CreateServiceEnumerationHandle auf eine Teilmenge zurückgibt, die durch eine Kombination aus ExclusionFlags und Werten in den entsprechenden Membern von CriteriaService definiert wird. Dieser Parameter ist einer der folgenden Werte.

Wert Bedeutung
STM_ONLY_THIS_INTERFACE
 Listet nur die Dienste auf, die über die im InterfaceIndex-Member von CriteriaService angegebene Schnittstelle abgerufen wurden.
STM_ONLY_THIS_PROTOCOL
 Enumerieren Sie nur die Dienste, die über das Protokoll abgerufen wurden, das im Protokollmitglied von CriteriaService angegeben ist. Beispielsweise IPX_PROTOCOL_SAP für Dienste, die vom DLL-Protokoll abgerufen werden, oder IPX_PROTOCOL_STATIC für Dienste, die vom Router-Manager verwaltet werden.
STM_ONLY_THIS_TYPE
 Enumerieren Sie nur die Dienste, die denselben Typ wie die Dienste im Service-Member von CriteriaService aufweisen.

[in] CriteriaService

Zeiger auf eine IPX_SERVICE-Struktur mit Memberwerten, die den in ExclusionFlags angegebenen Werten entsprechen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für die Verwendung mit der Dienstaufzählungsfunktion.

Ein NULL-Handle gibt an, dass keine Dienste mit den angegebenen Kriterien vorhanden sind oder dass der Vorgang fehlgeschlagen ist. Weitere Informationen finden Sie unter GetLastError , und überprüfen Sie den Fehlercode anhand der folgenden Tabelle.

Wert BESCHREIBUNG
ERROR_NO_SERVICES
 Es sind keine Dienste mit den angegebenen Kriterien 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

CloseServiceEnumerationHandle

EnumerateGetNextService

GetLastError

IPX-Diensttabellenverwaltung

IPX_SERVICE

Diensttabellenverwaltungsfunktionen

  • Last updated on