ADJHANDLELIST: Difference between revisions
No edit summary |
mNo edit summary |
||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
==Type== | ==Type== | ||
USHORT cMaxHandles; | |||
USHORT cHandle; | |||
[[ADJINFO]] Adj[1]; | |||
==C Declaration Method== | ==C Declaration Method== | ||
typedef struct | typedef struct | ||
typedef struct _ADJHANDLELIST { | typedef struct _ADJHANDLELIST { | ||
USHORT cMaxHandles; | USHORT cMaxHandles; | ||
| Line 15: | Line 14: | ||
} ADJHANDLELIST; | } ADJHANDLELIST; | ||
typedef | typedef ADJHANDLELIST * PADJHANDLELIST; | ||
==Fields== | |||
;cMaxHandles (USHORT):Number of handles that can be accepted in the handles array. This field must be set by the caller. | |||
:The default ADJHANDLELIST provides room for one handle. In this case, cMaxHandles must be set to 1. Refer to the example in RMKeyToHandleList, if more than one Adjunct handle is expected. | |||
;cHandle (USHORT):Actual handle count found. This field must be initially set to zero by the caller. | |||
:The number of handles reported by this field may exceed cMaxHandles. This indicates that the HANDLELIST structure supplied was too small. The count will be set to the number of handles actually found. | |||
[[Category:Data type]] | [[Category:Data type]] | ||
Latest revision as of 01:21, 13 December 2019
Type
USHORT cMaxHandles; USHORT cHandle; ADJINFO Adj[1];
C Declaration Method
typedef struct
typedef struct _ADJHANDLELIST {
USHORT cMaxHandles;
USHORT cHandle;
ADJINFO Adj[1];
} ADJHANDLELIST;
typedef ADJHANDLELIST * PADJHANDLELIST;
Fields
- cMaxHandles (USHORT)
- Number of handles that can be accepted in the handles array. This field must be set by the caller.
- The default ADJHANDLELIST provides room for one handle. In this case, cMaxHandles must be set to 1. Refer to the example in RMKeyToHandleList, if more than one Adjunct handle is expected.
- cHandle (USHORT)
- Actual handle count found. This field must be initially set to zero by the caller.
- The number of handles reported by this field may exceed cMaxHandles. This indicates that the HANDLELIST structure supplied was too small. The count will be set to the number of handles actually found.