CreateHandoffTable function

The CreateHandoffTable function creates a handoff table that includes the handoff set information stored in the INI file of the parser.

Syntax

DWORD WINAPI CreateHandoffTable(
  _In_  LPSTR          secName,
  _In_  LPSTR          iniFile,
  _Out_ LPHANDOFFTABLE *hTable,
  _In_  DWORD          nMaxProtocolEntries,
  _In_  DWORD          base
);

Parameters

secName [in]

String that indicates the section of the INI file where the handoff set information is located.

iniFile [in]

String that includes the name of the parser INI file.

hTable [out]

Handle to a HANDOFFTABLE structure created and maintained by Network Monitor.

nMaxProtocolEntries [in]

Number that specifies the maximum number of entries that the handoff table can process.

base [in]

Numerical base of handoff set numbers stored in the INI file.

Return value

If the function is successful, the return value is the number of entries in the handoff table.

If the function is unsuccessful, the return value is zero.

Remarks

The handoff table created by Network Monitor is based on information provided in the parser INI. The returned handle to the handoff table can then be used to obtain a handle to one of the protocols included in the table. To obtain a handle of one of these protocols, call GetProtocolFromTable.

Notice that the parser application never accesses the HANDOFFTABLE structure directly. This structure is created and maintained by Network Monitor.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Netmon.h
Library	Nmapi.lib
DLL	Nmapi.dll

See also

GetProtocolFromTable

HANDOFFTABLE