Funzione WdsCliLog (wdsclientapi.h)

Articolo
03/03/2024

Invia un evento di log al server WDS.

Sintassi

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

Parametri

[in] hSession

Handle a una sessione con un server WDS. Questo è stato un handle restituito dalla funzione WdsCliCreateSession .

[in] ulLogLevel

Indica la gravità della soglia necessaria per registrare un evento. Il server WDS registra eventi solo se il livello di log del server è maggiore o uguale al valore specificato.

Questo parametro può avere uno dei valori seguenti.

WDS_LOG_LEVEL_DISABLED (0)

WDS_LOG_LEVEL_ERROR (1)

WDS_LOG_LEVEL_WARNING (2)

WDS_LOG_LEVEL_INFO (3)

[in] ulMessageCode

Tipo di messaggio registrato.

Valore	Significato
WDS_LOG_TYPE_CLIENT_ERROR 1	Messaggio di errore del client. È necessario un parametro aggiuntivo di tipo PWSTR che descrive l'errore.
WDS_LOG_TYPE_CLIENT_STARTED 2	Messaggio avviato dal client. Non sono necessari parametri aggiuntivi.
WDS_LOG_TYPE_CLIENT_FINISHED 3	Messaggio completato dal client. Non sono necessari parametri aggiuntivi.
WDS_LOG_TYPE_CLIENT_IMAGE_SELECTED 4	Messaggio selezionato per un'immagine client. Sono necessari due parametri aggiuntivi di tipo PWSTR . Il primo è il nome immagine e il secondo è il nome del gruppo.
WDS_LOG_TYPE_CLIENT_APPLY_STARTED 5	Non sono necessari parametri aggiuntivi.
WDS_LOG_TYPE_CLIENT_APPLY_FINISHED 6	Non sono necessari parametri aggiuntivi.
WDS_LOG_TYPE_CLIENT_GENERIC_MESSAGE 7	Messaggio generico. È necessario un parametro aggiuntivo di tipo PWSTR contenente il messaggio.
WDS_LOG_TYPE_CLIENT_MAX_CODE 8	Usato per determinare un indice out-of-range. I valori maggiori o uguali a WDS_LOG_TYPE_CLIENT_MAX_CODE non sono validi.

...

La quantità e il tipo degli argomenti aggiuntivi varia con il valore del parametro ulMessageCode .

Valore restituito

Se la funzione ha esito positivo, la restituzione è S_OK.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wdsclientapi.h
Libreria	WdsClientAPI.lib
DLL	WdsClientAPI.dll

Vedi anche

WdsCliCreateSession

Funzioni client di Servizi di distribuzione Windows

Condividi tramite