Logo Search packages:      
Sourcecode: wireshark version File versions

BOOL AirpcapGetDriverKeys ( PAirpcapHandle  AdapterHandle,
PAirpcapKeysCollection  KeysCollection,
PUINT  PKeysCollectionSize 
)

Returns the global list of decryption keys in the driver that are associated with all the devices.

Parameters:
AdapterHandle Handle to an open adapter instance.
KeysCollection User-allocated PAirpcapKeysCollection structure that will be filled with the keys.
PKeysCollectionSize IN: pointer to a user-allocated variable that contains the length of the KeysCollection structure, in bytes. OUT: amount of data moved by the driver in the buffer pointed by KeysBuffer, in bytes.
Returns:
TRUE if the operation is succesful. If an error occurs, the return value is FALSE and KeysCollectionSize is zero. If the provided buffer is too small to contain the keys, the return value is FALSE and KeysCollectionSize contains the needed KeysCollection length, in bytes. If the device doesn't have any decryption key configured, the return value is TRUE, and KeysCollectionSize will be zero.
This function returns the global driver set of keys. These keys will be used by all the adapters plugged in the machine.

The AirPcap driver is able to use a set of decryption keys to decrypt the traffic transmitted on a specific SSID. If one of the keys corresponds to the one the frame has been encrypted with, the driver will perform decryption and return the cleartext frames to the application.

At this time, the only supported decryption method is WEP.


Generated by  Doxygen 1.6.0   Back to index