RPC_IF_HANDLE

  • Articolo

Il tipo di dati RPC_IF_HANDLE dichiara un handle di interfaccia.

typedef void __RPC_FAR* RPC_IF_HANDLE;

Commenti

La libreria di runtime RPC usa gli handle dell'interfaccia per accedere alla struttura dei dati delle specifiche dell'interfaccia. Il compilatore MIDL crea automaticamente una struttura di dati di specifica dell'interfaccia da ogni file IDL e crea una variabile globale di tipo RPC_IF_HANDLE per la specifica dell'interfaccia.

Il compilatore MIDL include un handle di interfaccia in ogni file di intestazione generato per l'interfaccia. Le funzioni che richiedono la specifica dell'interfaccia come parametro mostrano un tipo di dati di RPC_IF_HANDLE. Il formato di ogni nome dell'handle di interfaccia è il seguente:

  • if-name_ClientIfHandle (per il client)
  • if-name_ServerIfHandle (per il server)

La parte if-name specifica l'identificatore dell'interfaccia nel file IDL.

Ad esempio:

hello_ClientIfHandle

hello_ServerIfHandle

Nota

La lunghezza massima del nome dell'handle di interfaccia è di 31 caratteri.

Poiché le parti "_ClientIfHandle" e "_ServerIfHandle" dei nomi richiedono 15 caratteri, l'elemento if-name non può essere più di 16 caratteri.

Requisiti

Requisito Valore
Client minimo supportato
 Windows 2000 Professional [solo app desktop]
Server minimo supportato
 Windows 2000 Server [solo app desktop]
Intestazione
Rpcdce.h (include Rpc.h)