attribut implicit_handle

Das [implicit_handle] ACF-Attribut gibt das Handle an, das für Funktionen verwendet wird, die kein explizites Handle als Prozedurparameter enthalten.

implicit_handle(handle-type handle-name)

Parameter

handle-type

Gibt den Handle-Datentyp an, z. B. den Basistyp handle_t oder einen benutzerdefinierten Handle-Typ.

handle-name

Gibt den Namen des Handle an.

Bemerkungen

Das vom [implicit_handle] -Attribut angegebene Handle wird je nach Art der Prozedur auf unterschiedliche Weise verwendet. Wenn es sich bei der Prozedur um eine Remoteprozedur handelt, wird das Handle als Bindungshandle für den Remoteaufruf verwendet. Das implizite Handle kann auch verwendet werden, um eine anfängliche Bindung für eine Funktion herzustellen, die ein Kontexthandle verwendet. Wenn es sich bei der Prozedur um eine Serialisierungsprozedur handelt, wird das Handle als serialisierender Handle verwendet, der den Vorgang steuert. Im Fall der Typserialisierung wird das Handle als Serialisierungshandle für alle serialisierten Typen verwendet.

Das Attribut [implicit_handle] gibt eine globale Variable an, die ein Handle enthält, das von jeder Funktion verwendet wird, die implizite Handles benötigt.

Der implizite Bindungshandletyp muss entweder handle_t (oder ein Typ basierend auf handle_t) oder ein benutzerdefinierter Handle-Typ sein, der mit dem handle-Attribut angegeben ist. Das implizite Serialisierungshandle muss ein Typ sein, der auf handle_t basiert.

Wenn der implizite Handle-Typ nicht in der IDL-Datei oder in allen Dateien definiert ist, die von der IDL-Datei für den MIDL-Computer importiert werden, müssen Sie die Datei mit der Handle-Type-Definition angeben, wenn Sie die Stubs kompilieren. Verwenden Sie die ACF include-Anweisung, um die Datei einzuschließen, die die Handle-Type-Definition enthält.

Das [implicit_handle] -Attribut kann höchstens einmal auftreten. Das [implicit_handle] -Attribut kann nur auftreten, wenn die Attribute [auto_handle] und [explicit_handle] nicht auftreten.

Beispiele

/* ACF file */ 
[
    implicit_handle(handle_t hMyHandle)
] 
interface iface
{ 
    // Attribute configuration statements
}

Weitere Informationen

Anwendungskonfigurationsdatei (Application Configuration File, ACF)

auto_handle

explicit_handle

handle_t

einschließen