CLUSCTL_USER_CODE Makro (clusapi.h)

Generiert einen ordnungsgemäß formatierten benutzerdefinierten Steuerelementcode. Weitere Informationen zum Bitlayout von Steuerelementcodes finden Sie unter Steuerelementcodearchitektur.

Syntax

void CLUSCTL_USER_CODE(
   Function,
   Object
);

Parameter

Function

Wert, der den Vorgangscode (Bits 0–23) und optional den Zugriffscode (Bits 0–1) des resultierenden Steuerelementcodes angibt. Der Vorgangscode kann ein beliebiger 19-Bit-Wert sein, der vom Aufrufer ausgewählt wird. Der Zugriffscode (sofern angegeben) sollte auf einen der folgenden Werte festgelegt werden.

0 (CLUS_ACCESS_ANY)

Für den Steuerungscode gelten keine Zugriffsanforderungen.

1 (CLUS_ACCESS_READ)

Die Verwendung des Steuerungscodes erfordert Lesezugriff.

2 (CLUS_ACCESS_WRITE)

Die Verwendung des Steuerelementcodes erfordert Schreibzugriff.

Object

Ein 8-Bit-Wert, der den Objektcode (Bits 24–31) des resultierenden Steuerelementcodes angibt. Weitere Informationen zum Bitlayout von Steuerelementcodes finden Sie unter Steuerelementcodearchitektur. Der Objektcode kann auf einen beliebigen Wert festgelegt werden, der größer als CLUS_OBJECT_USER (128) ist.

Rückgabewert

Keine

Bemerkungen

Übergeben Sie keine bitversetzten Werte für Function oder Object. Das Makro führt die erforderlichen Bitverschiebungen aus.

Wenn kein Zugriffscode angegeben ist, wird der Steuerungscode standardmäßig auf CLUS_ACCESS_ANY festgelegt.

Beispiele

Sehen Sie sich das Beispiel unter Erstellen von Steuerelementcodes an.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Zielplattform	Windows
Kopfzeile	clusapi.h

Weitere Informationen

CLUSCTL_GET_ACCESS_MODE

CLUSCTL_GET_CONTROL_FUNCTION

CLUSCTL_GET_CONTROL_OBJECT