WTSCloudAuthGetServerNonce function (wtsapi32.h)

Requests a server nonce from the Cloud Authentication security support provider.

Syntax

BOOL WINAPI WTSCloudAuthGetServerNonce(
    [in] WTS_CLOUD_AUTH_HANDLE cloudAuthHandle,
    [out] PWSTR* serverNonce
);

Syntax

BOOL WTSCloudAuthGetServerNonce(
  [in]  WTS_CLOUD_AUTH_HANDLE cloudAuthHandle,
  [out] PWSTR                 *serverNonce
);

Parameters

[in] cloudAuthHandle

The cloud authentication handle obtained by calling WTSCloudAuthOpen.

[out] serverNonce

Receives the generated server nonce if the function succeeds. To free the allocated memory, call the WTSFreeMemoryEx function and pass WTSTypeCloudAuthServerNonce for the WTSTypeClass parameter.

Return value

If the function succeeds, the return value is a nonzero value. If the function fails, the return value is zero. To get extended error information, call the GetLastError function.

Remarks

The server nonce is required to build an assertion to authenticate to the server when using Entra authentication. The caller is responsible for transporting the server nonce to the client to use for the purposes of constructing the assertion.

Requirements