WdsCliInitializeLog function (wdsclientapi.h)

Initializes logging for the WDS client.

Syntax

HRESULT WDSCLIAPI WdsCliInitializeLog(
  [in] HANDLE hSession,
  [in] ULONG  ulClientArchitecture,
  [in] PWSTR  pwszClientId,
  [in] PWSTR  pwszClientAddress
);

Parameters

[in] hSession

A handle to a session with a WDS server. This was a handle returned by the WdsCliCreateSession function.

[in] ulClientArchitecture

A constant that identifies the processor architecture of the client.

This parameter can have one of the following values.

Value	Meaning
PROCESSOR_ARCHITECTURE_AMD64 9	The image is an x64 image (AMD AMD64 or Intel EM64T).
PROCESSOR_ARCHITECTURE_IA64 6	The image is an Itanium-based system image.
PROCESSOR_ARCHITECTURE_INTEL 0	The image is a 32-bit Intel x86 image.

[in] pwszClientId

A pointer to a string value that contains a GUID that represents this WDS client. This is typically the GUID for the System Management BIOS (SMBIOS.)

[in] pwszClientAddress

A pointer to a string value that contains the network address of the WDS client. This is typically the IP address in string form, for example, "127.0.0.1".

Return value

If the function succeeds, the return is S_OK.

If logging has already been initialize for the session, the return value is HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED).

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	wdsclientapi.h
Library	WdsClientAPI.lib
DLL	WdsClientAPI.dll

See also

WdsCliClose

WdsCliFindFirstImage

WdsCliFindNextImage

Windows Deployment Services Client Functions