MprAdminServerSetCredentials function (mprapi.h)

The MprAdminServerSetCredentials functions sets the pre-shared key for the specified server.

Syntax

DWORD MprAdminServerSetCredentials(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

[in] hMprServer

Handle to a Windows server. Obtain this handle by calling MprAdminMIBServerConnect.

[in] dwLevel

A DWORD value that describes the format in which the information is structured in the lpbBuffer parameter. Must be zero.

[in] lpbBuffer

A pointer to an MPR_CREDENTIALSEX_1 structure that contains the pre-shared key for the server.

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following error codes.

Value	Meaning
ERROR_ACCESS_DENIED	The calling application does not have sufficient privileges.
ERROR_INVALID_PARAMETER	The lpbBuffer parameter is NULL.
ERROR_NOT_SUPPORTED	The dwLevel parameter is not zero.
Other	Use FormatMessage to retrieve the system error message that corresponds to the error code returned.

The server maintains a single pre-shared key for all users.

To delete the pre-shared key, call MprAdminServerSetCredentials with the MPR_CREDENTIALSEX_1dwSize member set to zero.

Requirement	Value
Minimum supported client	None supported
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	mprapi.h
Library	Mprapi.lib
DLL	Mprapi.dll