WdsCliLog, fonction (wdsclientapi.h)

Article
03/03/2024

Envoie un événement de journal au serveur WDS.

Syntaxe

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

Paramètres

[in] hSession

Handle pour une session avec un serveur WDS. Il s’agissait d’un handle retourné par la fonction WdsCliCreateSession .

[in] ulLogLevel

Indique la gravité du seuil requis pour journaliser un événement. Le serveur WDS journalise les événements uniquement si le niveau de journalisation du serveur est supérieur ou égal à la valeur spécifiée.

Ce paramètre peut avoir l’une des valeurs suivantes.

WDS_LOG_LEVEL_DISABLED (0)

WDS_LOG_LEVEL_ERROR (1)

WDS_LOG_LEVEL_WARNING (2)

WDS_LOG_LEVEL_INFO (3)

[in] ulMessageCode

Type de message journalisé.

Valeur	Signification
WDS_LOG_TYPE_CLIENT_ERROR 1	Message d’erreur client. Un paramètre supplémentaire de type PWSTR qui décrit l’erreur est requis.
WDS_LOG_TYPE_CLIENT_STARTED 2	Message de démarrage d’un client. Aucun paramètre supplémentaire n’est nécessaire.
WDS_LOG_TYPE_CLIENT_FINISHED 3	Message client terminé. Aucun paramètre supplémentaire n’est nécessaire.
WDS_LOG_TYPE_CLIENT_IMAGE_SELECTED 4	Message d’image client sélectionnée. Deux paramètres supplémentaires de type PWSTR sont requis. Le premier est le nom de l’image et le second est le nom du groupe.
WDS_LOG_TYPE_CLIENT_APPLY_STARTED 5	Aucun paramètre supplémentaire n’est nécessaire.
WDS_LOG_TYPE_CLIENT_APPLY_FINISHED 6	Aucun paramètre supplémentaire n’est nécessaire.
WDS_LOG_TYPE_CLIENT_GENERIC_MESSAGE 7	Message générique. Un paramètre supplémentaire de type PWSTR qui contient le message est requis.
WDS_LOG_TYPE_CLIENT_MAX_CODE 8	Permet de déterminer un index hors limites. Les valeurs supérieures ou égales à WDS_LOG_TYPE_CLIENT_MAX_CODE ne sont pas valides.

...

La quantité et le type des arguments supplémentaires varient en fonction de la valeur du paramètre ulMessageCode .

Valeur retournée

Si la fonction réussit, le retour est S_OK.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wdsclientapi.h
Bibliothèque	WdsClientAPI.lib
DLL	WdsClientAPI.dll

Voir aussi

WdsCliCreateSession

Fonctions clientes des services de déploiement Windows

Partager via