Edit

WdsCliInitializeLog function (wdsclientapi.h)

  • Article

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