CopyAcceleratorTable

  int CopyAcceleratorTable(hacclOriginal, lpacclCopy, cAccel)    
  HACCEL hacclOriginal; /* handle of accelerator table to copy */
  LPACCEL lpacclCopy; /* address of structure receiving copy */
  int cAccel; /* number of entries in table being copied */

The CopyAcceleratorTable function copies the given accelerator table. This function is used to obtain the accelerator-table data that corresponds to an accelerator table handle or to determine the size of the accelerator-table data.

Parameters

hacclOriginal

Identifies the accelerator table to be copied.

lpacclCopy

Points to the area of memory where the accelerator-table information will be copied (in the form of an array of ACCEL structures). If this parameter is NULL, the function will return the number of accelerator-table entries in the original table. The ACCEL structure has the following form:

typedef struct tagACCEL { /* accl */

BYTE fVirt;

WORD key;

WORD cmd;

} ACCEL, *LPACCEL;

cAccel

Specifies the number of ACCEL structures to copy to the buffer pointed to by the lpacclCopy parameter.

Return Value

If lpacclCopy is NULL, the return value specifies the number of accelerator-table entries in the original table. If lpacclCopy is not NULL, the return value specifies the number of accelerator-table entries that were copied.

See Also

CreateAcceleratorTable, DestroyAcceleratorTable, LoadAccelerators, TranslateAccelerator