auto_handle-Attribut
Das [auto_handle] -ACF-Attribut weist den Stub an, automatisch die Bindung für eine Funktion einzurichten, die keinen expliziten Bindungshandleparameter aufweist.
Hinweis
Dieses Attribut ist veraltet und wird nicht mehr unterstützt. Die Verwendung des /robust-Schalters wird empfohlen.
[
auto_handle [, interface-attribute-list]
]
interface interface-name
{
interface-definition
}
Parameter
-
interface-attribute-list
-
Gibt null oder mehr Attribute an, die für die Schnittstelle als Ganzes gelten, z. B. Code oder Nocode. Trennen Sie Schnittstellenattribute durch Kommas.
-
Schnittstellenname
-
Gibt den Namen der Schnittstelle an.
-
Schnittstellendefinition
-
Gibt IDL-Anweisungen an, die die Definition der Schnittstelle bilden.
Bemerkungen
Das Attribut [auto_handle] wird im Schnittstellenheader des ACF angezeigt. Sie wird auch im Schnittstellenheader der IDL-Datei angezeigt, wenn Sie den MIDL-Compilerschalter /app_config angeben.
Wenn der Client eine Funktion aufruft, die die automatische Bindung verwendet, und keine Bindung an einen Server vorhanden ist, richtet der Stub die Bindung automatisch ein. Die Bindung wird für nachfolgende Aufrufe anderer Funktionen in der Schnittstelle wiederverwendet, die die automatische Bindung verwenden. Das Clientanwendungsprogramm muss keine Verarbeitung im Zusammenhang mit dem Bindungshandle deklarieren oder durchführen.
Wenn der ACF nicht vorhanden ist oder das Attribut [implicit_handle] nicht enthält, verwendet der MIDL-Compiler [auto_handle] und gibt eine Informationsmeldung aus. Der MIDL-Compiler verwendet bei Bedarf auch [auto_handle], um die anfängliche Bindung für einen [context_handle] einzurichten.
Das [auto_handle]- Attribut kann nur auftreten, wenn das Attribut [implicit_handle] oder [explicit_handle] nicht auftritt. Das Attribut [auto_handle] kann höchstens einmal im ACF- oder IDL-Schnittstellenheader auftreten.
Hinweis
Sie können die automatische Bindung nicht verwenden (entweder mit dem [ auto_handle]- Attribut oder standardmäßig), wenn Sie Daten über Pipes verarbeiten.
Beispiele
[
auto_handle
]
interface MyInterface
{
/* Interface definition goes here*/
}
[
auto_handle,
code
]
interface MyInterface
{
/* Interface definition goes here*/
}
Weitere Informationen