SLRegisterEvent-Funktion (slpublic.h)

Registriert ein Ereignis im SL-Dienst. Der Aufrufer kann Benachrichtigungen empfangen, wenn das registrierte Ereignis ausgelöst wird.

Syntax

HRESULT SLRegisterEvent(
  [in, optional] HSLC       hSLC,
  [in]           PCWSTR     pwszEventId,
  [in]           const SLID *pApplicationId,
  [in]           HANDLE     hEvent
);

Parameter

[in, optional] hSLC

Typ: HSLC

Das Handle für die aktuelle SLC-Sitzung.

[in] pwszEventId

Typ: PCWSTR

Der vordefinierte SL-Ereignisbezeichner.

[in] pApplicationId

Typ: const SLID*

Ein Zeiger auf die Anwendungs-ID, für die das Ereignis registriert wird.

[in] hEvent

Typ: HANDLE

Das Ereignishandle, das für die Benachrichtigung verwendet wird.

Rückgabewert

Typ: HRESULT WINAPI

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Rückgabecode/-wert	BESCHREIBUNG
SL_E_INVALID_EVENT_ID 0xC004F019	Die angeforderte Ereignis-ID ist ungültig.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	slpublic.h
Bibliothek	Slc.lib
DLL	Slc.dll