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. |