Función WdsCliLog (wdsclientapi.h)

Envía un evento de registro al servidor WDS.

Sintaxis

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

Parámetros

[in] hSession

Identificador de una sesión con un servidor WDS. Se trata de un identificador devuelto por la función WdsCliCreateSession .

[in] ulLogLevel

Indica la gravedad del umbral necesaria para registrar un evento. El servidor WDS registrará eventos solo si el nivel de registro del servidor es mayor o igual que el valor especificado.

Este parámetro puede tener uno de los siguientes valores.

WDS_LOG_LEVEL_DISABLED (0)

WDS_LOG_LEVEL_ERROR (1)

WDS_LOG_LEVEL_WARNING (2)

WDS_LOG_LEVEL_INFO (3)

[in] ulMessageCode

Tipo de mensaje que se está registrando.

Valor	Significado
WDS_LOG_TYPE_CLIENT_ERROR 1	Mensaje de error de cliente. Se requiere un parámetro adicional de tipo PWSTR que describa el error.
WDS_LOG_TYPE_CLIENT_STARTED 2	Un mensaje iniciado por el cliente. No hay ningún otro parámetro obligatorio.
WDS_LOG_TYPE_CLIENT_FINISHED 3	Un cliente finalizó el mensaje. No hay ningún otro parámetro obligatorio.
WDS_LOG_TYPE_CLIENT_IMAGE_SELECTED 4	Mensaje seleccionado de imagen de cliente. Se requieren dos parámetros adicionales de tipo PWSTR . La primera es el nombre de la imagen y la segunda es el nombre del grupo.
WDS_LOG_TYPE_CLIENT_APPLY_STARTED 5	No hay ningún otro parámetro obligatorio.
WDS_LOG_TYPE_CLIENT_APPLY_FINISHED 6	No hay ningún otro parámetro obligatorio.
WDS_LOG_TYPE_CLIENT_GENERIC_MESSAGE 7	Mensaje genérico. Se requiere un parámetro adicional de tipo PWSTR que contenga el mensaje.
WDS_LOG_TYPE_CLIENT_MAX_CODE 8	Se usa para determinar un índice fuera del intervalo. Los valores mayores o iguales que WDS_LOG_TYPE_CLIENT_MAX_CODE no son válidos.

...

La cantidad y el tipo de los argumentos adicionales varían con el valor del parámetro ulMessageCode .

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es S_OK.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wdsclientapi.h
Library	WdsClientAPI.lib
Archivo DLL	WdsClientAPI.dll

Consulte también

WdsCliCreateSession

Funciones de cliente de Servicios de implementación de Windows