FaxExtInitializeConfig function (faxext.h)

The fax service calls the FaxExtInitializeConfig function to initialize the fax extension DLL. The service calls this function before it calls any other fax extension initialization function.

Syntax

HRESULT FaxExtInitializeConfig(
  [in] PFAX_EXT_GET_DATA              unnamedParam1,
  [in] PFAX_EXT_SET_DATA              unnamedParam2,
  [in] PFAX_EXT_REGISTER_FOR_EVENTS   unnamedParam3,
  [in] PFAX_EXT_UNREGISTER_FOR_EVENTS unnamedParam4,
  [in] PFAX_EXT_FREE_BUFFER           unnamedParam5
);

Parameters

[in] unnamedParam1

Type: PFAX_EXT_GET_DATA

Pointer to a FaxExtGetData fax service callback function.

[in] unnamedParam2

Type: PFAX_EXT_SET_DATA

Pointer to a FaxExtSetData fax service callback function.

[in] unnamedParam3

Type: PFAX_EXT_REGISTER_FOR_EVENTS

Pointer to a FaxExtRegisterForEvents fax service callback function.

[in] unnamedParam4

Type: PFAX_EXT_UNREGISTER_FOR_EVENTS

Pointer to a FaxExtUnregisterForEvents fax service callback function.

[in] unnamedParam5

Type: PFAX_EXT_FREE_BUFFER

Pointer to a FaxExtFreeBuffer fax service callback function.

Return value

Type: HRESULT

If the function succeeds, the return value is NOERROR.

If the fax extension DLL returns a value other than NOERROR, the fax service considers the extension to be in an error state. Even if other extension initialization functions succeed, the fax service does not recognize the extension.

Remarks

A fax extension DLL must export FaxExtInitializeConfig if it plans to implement the fax extension configuration mechanism and receive notifications from the fax service about changes in device configuration data.

The FaxExtInitializeConfig function exposes pointers to the callback functions that the fax service supplies. The fax extension DLL must store these pointers in a global variable for later use.

Requirements

See also

FaxExtFreeBuffer

FaxExtGetData

FaxExtRegisterForEvents

FaxExtSetData

FaxExtUnregisterForEvents