Função WdsCliLog (wdsclientapi.h)

Artigo
03/15/2023

Envia um evento de log para o servidor WDS.

Sintaxe

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

Parâmetros

[in] hSession

Um identificador para uma sessão com um servidor WDS. Esse foi um identificador retornado pela função WdsCliCreateSession .

[in] ulLogLevel

Indica a gravidade do limite necessária para registrar um evento em log. O servidor WDS registrará eventos somente se o nível de log do servidor for maior ou igual ao valor especificado.

Esse parâmetro pode ter um dos valores a seguir.

WDS_LOG_LEVEL_DISABLED (0)

WDS_LOG_LEVEL_ERROR (1)

WDS_LOG_LEVEL_WARNING (2)

WDS_LOG_LEVEL_INFO (3)

[in] ulMessageCode

O tipo de mensagem que está sendo registrada.

Valor	Significado
WDS_LOG_TYPE_CLIENT_ERROR 1	Uma mensagem de erro do cliente. Um parâmetro adicional do tipo PWSTR que descreve o erro é necessário.
WDS_LOG_TYPE_CLIENT_STARTED 2	Uma mensagem iniciada pelo cliente. Nenhum parâmetro adicional é necessário.
WDS_LOG_TYPE_CLIENT_FINISHED 3	Uma mensagem finalizada pelo cliente. Nenhum parâmetro adicional é necessário.
WDS_LOG_TYPE_CLIENT_IMAGE_SELECTED 4	Uma mensagem selecionada de imagem do cliente. Dois parâmetros adicionais do tipo PWSTR são necessários. O primeiro é o Nome da Imagem e o segundo é o Nome do Grupo.
WDS_LOG_TYPE_CLIENT_APPLY_STARTED 5	Nenhum parâmetro adicional é necessário.
WDS_LOG_TYPE_CLIENT_APPLY_FINISHED 6	Nenhum parâmetro adicional é necessário.
WDS_LOG_TYPE_CLIENT_GENERIC_MESSAGE 7	Uma mensagem genérica. Um parâmetro adicional do tipo PWSTR que contém a mensagem é necessário.
WDS_LOG_TYPE_CLIENT_MAX_CODE 8	Usado para determinar um índice fora do intervalo. Valores maiores ou iguais a WDS_LOG_TYPE_CLIENT_MAX_CODE não são válidos.

...

A quantidade e o tipo dos argumentos adicionais variam de acordo com o valor do parâmetro ulMessageCode .

Retornar valor

Se a função for bem-sucedida, o retorno será S_OK.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wdsclientapi.h
Biblioteca	WdsClientAPI.lib
DLL	WdsClientAPI.dll

Confira também

WdsCliCreateSession

Funções de cliente dos Serviços de Implantação do Windows

Compartilhar via