496 lines
16 KiB
C
496 lines
16 KiB
C
/*++
|
|
|
|
Copyright (C) 1997-1999 Microsoft Corporation
|
|
|
|
Module Name:
|
|
|
|
dhcpssdk.h
|
|
|
|
Abstract:
|
|
|
|
Header for writing a DHCP Callout DLL.
|
|
|
|
--*/
|
|
|
|
#ifndef _CALLOUT_H_
|
|
#define _CALLOUT_H_
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#if _MSC_VER > 1000
|
|
#pragma once
|
|
#endif
|
|
|
|
// This structure could change any day. This will be accurate only for version 0 -- which
|
|
// has to be checked for by any CalloutDLL that is hooking onto the DhcpHandleOptionsHook.
|
|
|
|
|
|
typedef DWORD DHCP_IP_ADDRESS;
|
|
typedef struct _DHCP_SERVER_OPTIONS {
|
|
BYTE *MessageType;
|
|
DHCP_IP_ADDRESS UNALIGNED *SubnetMask;
|
|
DHCP_IP_ADDRESS UNALIGNED *RequestedAddress;
|
|
DWORD UNALIGNED *RequestLeaseTime;
|
|
BYTE *OverlayFields;
|
|
DHCP_IP_ADDRESS UNALIGNED *RouterAddress;
|
|
DHCP_IP_ADDRESS UNALIGNED *Server;
|
|
BYTE *ParameterRequestList;
|
|
DWORD ParameterRequestListLength;
|
|
CHAR *MachineName;
|
|
DWORD MachineNameLength;
|
|
BYTE ClientHardwareAddressType;
|
|
BYTE ClientHardwareAddressLength;
|
|
BYTE *ClientHardwareAddress;
|
|
CHAR *ClassIdentifier;
|
|
DWORD ClassIdentifierLength;
|
|
BYTE *VendorClass;
|
|
DWORD VendorClassLength;
|
|
DWORD DNSFlags;
|
|
DWORD DNSNameLength;
|
|
LPBYTE DNSName;
|
|
BOOLEAN DSDomainNameRequested;
|
|
CHAR *DSDomainName;
|
|
DWORD DSDomainNameLen;
|
|
DWORD UNALIGNED *ScopeId;
|
|
} DHCP_SERVER_OPTIONS, *LPDHCP_SERVER_OPTIONS;
|
|
|
|
//
|
|
// The location in registry where the REG_MULTI_SZ list of callout DLLs
|
|
// that the DHCP Server will try to load.
|
|
//
|
|
|
|
#define DHCP_CALLOUT_LIST_KEY L"System\\CurrentControlSet\\Services\\DHCPServer\\Parameters"
|
|
#define DHCP_CALLOUT_LIST_VALUE L"CalloutDlls"
|
|
#define DHCP_CALLOUT_LIST_TYPE REG_MULTI_SZ
|
|
#define DHCP_CALLOUT_ENTRY_POINT "DhcpServerCalloutEntry"
|
|
|
|
//
|
|
// Control CODES used by DHCP Server to notify server state change.
|
|
//
|
|
|
|
#define DHCP_CONTROL_START 0x00000001
|
|
#define DHCP_CONTROL_STOP 0x00000002
|
|
#define DHCP_CONTROL_PAUSE 0x00000003
|
|
#define DHCP_CONTROL_CONTINUE 0x00000004
|
|
|
|
//
|
|
// Other ControlCodes used by various Callout HOOKS.
|
|
//
|
|
|
|
#define DHCP_DROP_DUPLICATE 0x00000001 // duplicate of pkt being processed
|
|
#define DHCP_DROP_NOMEM 0x00000002 // not enough server mem in queues
|
|
#define DHCP_DROP_INTERNAL_ERROR 0x00000003 // ooops?
|
|
#define DHCP_DROP_TIMEOUT 0x00000004 // too late, pkt is too old
|
|
#define DHCP_DROP_UNAUTH 0x00000005 // server is not authorized to run
|
|
#define DHCP_DROP_PAUSED 0x00000006 // service is paused
|
|
#define DHCP_DROP_NO_SUBNETS 0x00000007 // no subnets configured on server
|
|
#define DHCP_DROP_INVALID 0x00000008 // invalid packet or client
|
|
#define DHCP_DROP_WRONG_SERVER 0x00000009 // client in different DS enterprise
|
|
#define DHCP_DROP_NOADDRESS 0x0000000A // no address available to offer
|
|
#define DHCP_DROP_PROCESSED 0x0000000B // packet has been processed
|
|
#define DHCP_DROP_GEN_FAILURE 0x00000100 // catch-all error
|
|
#define DHCP_SEND_PACKET 0x10000000 // send the packet on wire
|
|
#define DHCP_PROB_CONFLICT 0x20000001 // address conflicted..
|
|
#define DHCP_PROB_DECLINE 0x20000002 // an addr got declined
|
|
#define DHCP_PROB_RELEASE 0x20000003 // an addr got released
|
|
#define DHCP_PROB_NACKED 0x20000004 // a client is being nacked.
|
|
#define DHCP_GIVE_ADDRESS_NEW 0x30000001 // give client a "new" address
|
|
#define DHCP_GIVE_ADDRESS_OLD 0x30000002 // renew client's "old" address
|
|
#define DHCP_CLIENT_BOOTP 0x30000003 // client is a BOOTP client
|
|
#define DHCP_CLIENT_DHCP 0x30000004 // client is a DHCP client
|
|
|
|
|
|
|
|
typedef
|
|
DWORD
|
|
(APIENTRY *LPDHCP_CONTROL)(
|
|
IN DWORD dwControlCode,
|
|
IN LPVOID lpReserved
|
|
)
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This routine is called whenever the DHCP Server service is
|
|
started, stopped, paused or continued as defined by the values of
|
|
the dwControlCode parameter. The lpReserved parameter is reserved
|
|
for future use and it should not be interpreted in any way. This
|
|
routine should not block.
|
|
|
|
Arguments:
|
|
|
|
dwControlCode - one of the DHCP_CONTROL_* values
|
|
lpReserved - reserved for future use.
|
|
|
|
--*/
|
|
;
|
|
|
|
typedef
|
|
DWORD
|
|
(APIENTRY *LPDHCP_NEWPKT)(
|
|
IN OUT LPBYTE *Packet,
|
|
IN OUT DWORD *PacketSize,
|
|
IN DWORD IpAddress,
|
|
IN LPVOID Reserved,
|
|
IN OUT LPVOID *PktContext,
|
|
OUT LPBOOL ProcessIt
|
|
)
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This routine is called soon after the DHCP Server receives a
|
|
packet that it attempts to process. This routine is in the
|
|
critical path of server execution and should return very fast, as
|
|
otherwise server performance will be impacted. The Callout DLL
|
|
can modify the buffer or return a new buffer via the Packet,
|
|
PacketSize arguments. Also, if the callout DLL has internal
|
|
structures to keep track of the packet and its progress, it can
|
|
then return a context to this packet in the PktContext parameter.
|
|
This context will be passed to almost all other hooks to indicate
|
|
the packet being referred to. Also, if the Callout DLL is
|
|
planning on processing the packet or for some other reason the
|
|
DHCP server is not expected to process this packet, then it can
|
|
set the ProcessIt flag to FALSE to indicate that the packet is to
|
|
be dropped.
|
|
|
|
Arguments:
|
|
|
|
Packet - This parameter points to a character buffer that holds
|
|
the actual packet received by the DHCP Server.
|
|
|
|
PacketSize - This parameter points to a variable that holds the
|
|
size of the above buffer.
|
|
|
|
IpAddress - This parameter points to an IPV4 host order IP address
|
|
of the socket that this packet was received on.
|
|
|
|
Reserved -Reserved for future use.
|
|
|
|
PktContect - This is an opaque pointer used by the DHCP Server for
|
|
future references to this packet. It is expected that the callout
|
|
DLL will provide this pointer if it is interested in keeping track
|
|
of the packet. (See the descriptions for the hooks below for
|
|
other usage of this Context).
|
|
|
|
ProcessIt - This is a BOOL flag that the CalloutDll can set to
|
|
TRUE or reset to indicate if the DHCP Server should continue
|
|
processing this packet or not, respectively.
|
|
|
|
--*/
|
|
;
|
|
|
|
typedef
|
|
DWORD
|
|
(APIENTRY *LPDHCP_DROP_SEND)(
|
|
IN OUT LPBYTE *Packet,
|
|
IN OUT DWORD *PacketSize,
|
|
IN DWORD ControlCode,
|
|
IN DWORD IpAddress,
|
|
IN LPVOID Reserved,
|
|
IN LPVOID PktContext
|
|
)
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This hook is called if a packet is (DropPktHook) dropped for some
|
|
reason or if the packet is completely processed. (If a packet is
|
|
dropped, the hook is called twice as it is called once again to
|
|
note that the packet has been completely processed). The callout
|
|
DLL should be prepared to handle this hook multiple times for a
|
|
packet. This routine should not block. The ControlCode parameter
|
|
defines the reasons for the packet being dropped:
|
|
|
|
* DHCP_DROP_DUPLICATE - This packet is a duplicate of another
|
|
received by the server.
|
|
* DHCP_DROP_NOMEM - Not enough memory to process the packet.
|
|
* DHCP_DROP_INTERNAL_ERROR - Unexpected nternal error occurred.
|
|
* DHCP_DROP_TIMEOUT - The packet is too old to process.
|
|
* DHCP_DROP_UNAUTH - The server is not authorized.
|
|
* DHCP_DROP_PAUSED - The server is paused.
|
|
* DHCP_DROP_NO_SUBNETS - There are no subnets configured.
|
|
* DHCP_DROP_INVALID - The packet is invalid or it came on an
|
|
invalid socket ..
|
|
* DHCP_DROP_WRONG_SERVER - The packet was sent to the wrong DHCP Server.
|
|
* DHCP_DROP_NOADDRESS - There is no address to offer.
|
|
* DHCP_DROP_PROCESSED - The packet has been processed.
|
|
* DHCP_DROP_GEN_FAILURE - An unknown error occurred.
|
|
|
|
This routine is also called right before a response is sent down
|
|
the wire (SendPktHook) and in this case the ControlCode has a
|
|
value of DHCP_SEND_PACKET.
|
|
|
|
Arguments:
|
|
|
|
Packet - This parameter points to a character buffer that holds
|
|
the packet being processed by the DHCP Server.
|
|
|
|
PacketSize - This parameter points to a variable that holds the
|
|
size of the above buffer.
|
|
|
|
ControlCode - See description for various control codes.
|
|
|
|
IpAddress - This parameter points to an IPV4 host order IP address
|
|
of the socket that this packet was received on.
|
|
|
|
Reserved - Reserved for future use.
|
|
|
|
PktContext - This parameter is the packet context that the Callout
|
|
DLL NewPkt Hook returned for this packet. This can be used to
|
|
track a packet.
|
|
|
|
--*/
|
|
;
|
|
|
|
typedef
|
|
DWORD
|
|
(APIENTRY *LPDHCP_PROB)(
|
|
IN LPBYTE Packet,
|
|
IN DWORD PacketSize,
|
|
IN DWORD ControlCode,
|
|
IN DWORD IpAddress,
|
|
IN DWORD AltAddress,
|
|
IN LPVOID Reserved,
|
|
IN LPVOID PktContext
|
|
)
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This routine is called whenever special events occur that cause
|
|
the packet to be dropped etc. The possible ControlCodes and their
|
|
meanings are as follows:
|
|
|
|
* DHCP_PROB_CONFLICT - The address attempted to be offered
|
|
(AltAddress) is in use in the network already.
|
|
* DHCP_PROB_DECLINE - The packet was a DECLINE message for the
|
|
address specified in AltAddress.
|
|
* DHCP_PROB_RELEASE - The packet was a RELEASE message for the
|
|
address specified in AltAddress.
|
|
* DHCP_PROB_NACKED - The packet was a REQUEST message for address
|
|
specified in AltAddress and it was NACKed by the server.
|
|
|
|
This routine should not block.
|
|
|
|
Arguments:
|
|
|
|
Packet - This parameter is the buffer of the packet being
|
|
processed.
|
|
|
|
PacketSize - This is the size of the above buffer.
|
|
|
|
ControlCode - Specifies the event. See description below for
|
|
control codes and meanings.
|
|
|
|
IpAddress - IpV4 address of socket this packet was received on.
|
|
|
|
AltAddress - Request IpV4 Address or Ip address that is in
|
|
conflict.
|
|
|
|
Reserved - Reserve for future use.
|
|
|
|
PktContext - This is the context returned by the NewPkt hook for
|
|
this packet.
|
|
|
|
--*/
|
|
;
|
|
|
|
typedef
|
|
DWORD
|
|
(APIENTRY *LPDHCP_GIVE_ADDRESS)(
|
|
IN LPBYTE Packet,
|
|
IN DWORD PacketSize,
|
|
IN DWORD ControlCode,
|
|
IN DWORD IpAddress,
|
|
IN DWORD AltAddress,
|
|
IN DWORD AddrType,
|
|
IN DWORD LeaseTime,
|
|
IN LPVOID Reserved,
|
|
IN LPVOID PktContext
|
|
)
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This routine is called when the server is about to send an ACK to
|
|
a REQUEST message. The ControlCode specifies if the address is a
|
|
totally new address or if it an renewal of an old address (with
|
|
values DHCP_GIVE_ADDRESS_NEW and DHCP_GIVE_ADDRESS_OLD
|
|
respectively). The address being offered is passed as the
|
|
AltAddress parameter and the AddrType parameter can be one of
|
|
DHCP_CLIENT_BOOTP or DHCP_CLIENT_DHCP indicating whether the
|
|
client is using BOOTP or DHCP respectively. This call should not
|
|
block.
|
|
|
|
Arguments:
|
|
|
|
Packet - This parameter is the buffer of the packet being
|
|
processed.
|
|
|
|
PacketSize - This is the size of the above buffer.
|
|
|
|
ControlCode - See description above for control codes and
|
|
meanings.
|
|
|
|
IpAddress - IpV4 address of socket this packet was received on.
|
|
|
|
AltAddress - IpV4 address being ACKed to the client.
|
|
|
|
AddrType - Is this a DHCP or BOOTP address?
|
|
|
|
LeaseTime - Lease duration being passed.
|
|
|
|
Reserved - Reserve for future use.
|
|
|
|
PktContext - This is the context returned by the NewPkt hook for
|
|
this packet.
|
|
|
|
--*/
|
|
;
|
|
|
|
typedef
|
|
DWORD
|
|
(APIENTRY *LPDHCP_HANDLE_OPTIONS)(
|
|
IN LPBYTE Packet,
|
|
IN DWORD PacketSize,
|
|
IN LPVOID Reserved,
|
|
IN LPVOID PktContext,
|
|
IN OUT LPDHCP_SERVER_OPTIONS ServerOptions
|
|
)
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This routine can be utilized by the CalloutDLL to avoid parsing
|
|
the whole packet. The packet is parsed by the server and some
|
|
commonly used options are returned in the parsed pointers
|
|
structure (see header for definition of DHCP_SERVER_OPTIONS). The
|
|
hook is expected to make a copy of the structure pointed to by
|
|
ServerOptions if it needs it beyond this function call. This
|
|
routine may be called several times for a single packet. This
|
|
routine should not block.
|
|
|
|
Arguments:
|
|
|
|
Packet - This parameter is the buffer of the packet being
|
|
processed.
|
|
|
|
PacketSize - This is the size of the above buffer.
|
|
|
|
Reserved - Reserve for future use.
|
|
|
|
PktContext - This is the context returned by the NewPkt hook for
|
|
this packet.
|
|
|
|
ServerOptions - This parameter is the structure that contains a
|
|
bunch of pointers that represent corresponding options.
|
|
|
|
--*/
|
|
;
|
|
|
|
typedef
|
|
DWORD
|
|
(APIENTRY *LPDHCP_DELETE_CLIENT)(
|
|
IN DWORD IpAddress,
|
|
IN LPBYTE HwAddress,
|
|
IN ULONG HwAddressLength,
|
|
IN DWORD Reserved,
|
|
IN DWORD ClientType
|
|
)
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This routine is called before a client lease is deleted off the
|
|
active leases database. The ClientType field is currently not
|
|
provided and this should not be used. This routine should not
|
|
block.
|
|
|
|
Arguments:
|
|
|
|
IpAddress - IpV4 address of the client lease being deleted.
|
|
|
|
HwAddress - Buffer holding the Hardware address of the client (MAC).
|
|
|
|
HwAddressLength - This specifies the length of the above buffer.
|
|
|
|
Reserved - Reserved for future use.
|
|
|
|
ClientType - Reserved for future use.
|
|
--*/
|
|
;
|
|
|
|
typedef
|
|
struct _DHCP_CALLOUT_TABLE {
|
|
LPDHCP_CONTROL DhcpControlHook;
|
|
LPDHCP_NEWPKT DhcpNewPktHook;
|
|
LPDHCP_DROP_SEND DhcpPktDropHook;
|
|
LPDHCP_DROP_SEND DhcpPktSendHook;
|
|
LPDHCP_PROB DhcpAddressDelHook;
|
|
LPDHCP_GIVE_ADDRESS DhcpAddressOfferHook;
|
|
LPDHCP_HANDLE_OPTIONS DhcpHandleOptionsHook;
|
|
LPDHCP_DELETE_CLIENT DhcpDeleteClientHook;
|
|
LPVOID DhcpExtensionHook;
|
|
LPVOID DhcpReservedHook;
|
|
} DHCP_CALLOUT_TABLE, *LPDHCP_CALLOUT_TABLE;
|
|
|
|
typedef
|
|
DWORD
|
|
(APIENTRY *LPDHCP_ENTRY_POINT_FUNC) (
|
|
IN LPWSTR ChainDlls,
|
|
IN DWORD CalloutVersion,
|
|
IN OUT LPDHCP_CALLOUT_TABLE CalloutTbl
|
|
)
|
|
/*++
|
|
|
|
Routine Description:
|
|
|
|
This is the routine that is called by the DHCP Server when it
|
|
successfully loads a DLL. If the routine succeeds, then the
|
|
DHCP Server does not attempt to load any of the DLLs specified in
|
|
the ChainDlls list of DLLs. If this function fails for some
|
|
reason, then the DHCP Server proceeds to the next DLL in the
|
|
ChainDlls structure.
|
|
|
|
Note that for version negotiation, the server may call this
|
|
routine several times until a compatible version is found.
|
|
|
|
It is expected that the entrypoint routine would walk through the
|
|
names of the dlls and attempt to load each of them and when it
|
|
succeeds in retrieving the entry point, it attempts to get the
|
|
cumulative set of hooks by repeating the above procedure (as done
|
|
by the DHCP Server).
|
|
|
|
Arguments:
|
|
|
|
ChainDlls - This is a set of DLL names in REG_MULTI_SZ format (as
|
|
returned by Registry function calls). This does not contain the
|
|
name of the current DLL itself, but only the names of all DLLs
|
|
that follow the current DLL.
|
|
|
|
CalloutVersion - This is the version that the Callout DLL is
|
|
expected to support. The current version number is 0.
|
|
|
|
CalloutTbl - This is the cumulative set of Hooks that is needed by
|
|
the current DLLs as well as all the DLLs in ChainDlls. It is the
|
|
responsibility of the current DLL to retrive the cumulative set of
|
|
Hooks and merge that with its own set of hooks and return that in
|
|
this table structure. The table structure is defined above.
|
|
|
|
--*/
|
|
;
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif _CALLOUT_H_
|
|
|
|
//========================================================================
|
|
// end of file
|
|
//========================================================================
|
|
|