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