tf6DhcpUserUpdateKey

Table of Contents >> Optional Protocols >> DHCPv6

#include <trsocket.h>

int tf6DhcpUserUpdateKey	(
	ttUserInterface interfaceHandle,
	const ttUser8BitPtr realmPtr,
	int realmLen,
	ttUser32Bit keyId,
	const ttUser8BitPtr keyPtr,
	int keyLen,
	int flags
	);

Function Description

Update a key being used by DHCPv6 authentication to the given value. Note: Key management and distribution are not described by the DHCPv6 RFC and are left entirely to the user. The RFC does specify that keys must expire after a set amount of time. When this occurs, keys may be removed or modified using tf6DhcpUserRemoveKey() or tf6DhcpUserUpdateKey().

Parameters

• interfaceHandle

  Handle to the interface on which to store the key

• realmPtr

  Pointer to a buffer containing the key’s realm. Must match realm provided by server.

• realmLen

  Length of the realm pointed to by realmPtr, in bytes.

• keyId

  Number used to identify the key. Unique per realm. Must match key id provided by server.

• keyPtr

  Pointer to a buffer containing the new key. Must match key used by server.

• keyLen

  Length of the key pointed to by keyPtr, in bytes.

• flags

  Currently unused

Returns

• TM_ENOERROR

  Sucessful

• TM_EINVAL

  Invalid parameter

• TM_ENOBUFS

  No memory available to save updated key

Table of Contents >> Optional Protocols >> DHCPv6