ADJHANDLELIST: Difference between revisions

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.

@@ Line 8: / Line 8: @@
   typedef struct
-==Example Code==
   typedef struct _ADJHANDLELIST {
     USHORT      cMaxHandles;
@@ Line 15: / Line 14: @@
   } ADJHANDLELIST;
-  typedef   ADJHANDLELIST   * PADJHANDLELIST ;
+  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]]