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.

[ 
    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.

Beispiele

[
    auto_handle
] 
interface MyInterface 
{ 
    /* Interface definition goes here*/
} 
[
    auto_handle, 
    code
] 
interface MyInterface
{ 
    /* Interface definition goes here*/
}

Weitere Informationen

Anwendungskonfigurationsdatei (Application Configuration File, ACF)

/app_config

Code

explicit_handle

context_handle

implicit_handle

nocode