Share via


GetProtocolFromTable

The GetProtocolFromTable function returns a handle to a protocol—based on a given handoff table and value.

HPROTOCOL WINAPIGetProtocolFromTable(LPHANDOFFTABLEhTable,
DWORDItemToFind,
PDWORD_PTRlpInstData);

Parameters

  • hTable
    [in] Handle to a handoff table.
  • ItemToFind
    [in] Value used to locate the protocol in a handoff table. The value must be available in the protocol data.
  • lpInstData
    [out] If available in the handoff table, instance data for the next protocol. Instance data cannot be longer than a DWORD_PTR in length.

Return Values

If the function is successful, the return value is a protocol handle.

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

Remarks

When implementing the RecognizeFrame export function, the GetProtocolFromTable function is used to obtain a handle to the next protocol. The GetProtocolFromTable function is called to retrieve a handle from the next protocol—if the protocol identifies which protocol follows.

Instance data

Instance data can be any data that is less than or equal to a DWORD_PTR in length, or a pointer to data, such as raw frame data, that does not need to be allocated by or freed by the parser.

Requirements

Client Requires Windows XP, Windows 2000 Professional, or Windows NT Workstation 4.0.
Server Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.
Header

Declared in Netmon.h.

Library

Link to Nmapi.lib.

DLL Requires Nmapi.dll.

See Also

RecognizeFrame