WdsCliLog-Funktion (wdsclientapi.h)

Artikel
03/06/2024

Sendet ein Protokollereignis an den WDS-Server.

Syntax

HRESULT WDSCLIAPI WdsCliLog(
  [in] HANDLE hSession,
  [in] ULONG  ulLogLevel,
  [in] ULONG  ulMessageCode,
       ...    
);

Parameter

[in] hSession

Ein Handle für eine Sitzung mit einem WDS-Server. Dies war ein Handle, der von der WdsCliCreateSession-Funktion zurückgegeben wurde.

[in] ulLogLevel

Gibt den Schwellenwertschweregrad an, der zum Protokollieren eines Ereignisses erforderlich ist. Der WDS-Server protokolliert Ereignisse nur, wenn die Serverprotokollebene größer oder gleich dem angegebenen Wert ist.

Dieser Parameter kann einen der folgenden Werte aufweisen.

WDS_LOG_LEVEL_DISABLED (0)

WDS_LOG_LEVEL_ERROR (1)

WDS_LOG_LEVEL_WARNING (2)

WDS_LOG_LEVEL_INFO (3)

[in] ulMessageCode

Der Typ der nachricht, die protokolliert wird.

Wert	Bedeutung
WDS_LOG_TYPE_CLIENT_ERROR 1	Eine Clientfehlermeldung. Ein zusätzlicher Parameter vom Typ PWSTR , der den Fehler beschreibt, ist erforderlich.
WDS_LOG_TYPE_CLIENT_STARTED 2	Eine Clientstartnachricht. Es sind keine weiteren Parameter erforderlich.
WDS_LOG_TYPE_CLIENT_FINISHED 3	Eine Clientnachricht wurde abgeschlossen. Es sind keine weiteren Parameter erforderlich.
WDS_LOG_TYPE_CLIENT_IMAGE_SELECTED 4	Eine ausgewählte Nachricht für ein Clientimage. Zwei zusätzliche Parameter vom Typ PWSTR sind erforderlich. Die erste ist der Imagename und der zweite der Gruppenname.
WDS_LOG_TYPE_CLIENT_APPLY_STARTED 5	Es sind keine weiteren Parameter erforderlich.
WDS_LOG_TYPE_CLIENT_APPLY_FINISHED 6	Es sind keine weiteren Parameter erforderlich.
WDS_LOG_TYPE_CLIENT_GENERIC_MESSAGE 7	Eine generische Nachricht. Ein zusätzlicher Parameter vom Typ PWSTR , der die Nachricht enthält, ist erforderlich.
WDS_LOG_TYPE_CLIENT_MAX_CODE 8	Wird verwendet, um einen Außerhalb des Bereichsindex zu bestimmen. Werte, die größer als oder gleich WDS_LOG_TYPE_CLIENT_MAX_CODE sind, sind ungültig.

...

Die Menge und der Typ der zusätzlichen Argumente variieren mit dem Wert des ulMessageCode-Parameters .

Rückgabewert

Wenn die Funktion erfolgreich ist, wird die Rückgabe S_OK.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wdsclientapi.h
Bibliothek	WdsClientAPI.lib
DLL	WdsClientAPI.dll

Weitere Informationen

WdsCliCreateSession

Clientfunktionen der Windows-Bereitstellungsdienste

Freigeben über