attributo di notifica

L'attributo [notify] indica al compilatore MIDL di generare una chiamata a una procedura [notifica] sul lato server dell'applicazione.

[notify] procedure-name();

Parametri

procedure-name

Nome della procedura remota con cui verrà associata la procedura di notifica.

Commenti

La procedura [notifica] chiamata come risultato dell'attributo [notify] è associata a una determinata procedura remota nel server. È simile al concetto di una funzione di callback. Lo stub chiama la procedura [notifica] dopo tutti gli argomenti di output della routine remota con cui è associato il marshalling e qualsiasi memoria associata ai parametri viene liberata. La routine [notifica] viene chiamata se una chiamata ha esito negativo prima dell'esecuzione della routine del server. Ad esempio, se un server ha esito negativo durante l'annullamento delmarshaling a causa della ricezione di dati non valido dal client, viene chiamata la routine [notifica].

L'attributo [notifica] è utile per sviluppare applicazioni che acquisiscono risorse nelle procedure remote. Queste risorse vengono quindi liberate nella procedura [notifica] dopo il marshalling completo dei parametri di output della procedura remota.

Il nome della procedura [notify] è il nome della routine remota suffisso in base alla _notify. La procedura _notify non richiede parametri e non restituisce un risultato. Un prototipo di questa procedura viene generato anche nel file di intestazione. Ad esempio, se il file IDL contiene quanto segue:

MyProcedure([in] short S);

Specificare quanto segue in ACF per MIDL per generare la chiamata _notify :

[notify] MyProcedure();

Il compilatore MIDL genererà il codice stub del server che contiene la chiamata seguente alla procedura di _notify :

MyProcedure_notify();

Il file di intestazione conterrà un prototipo:

void MyProcedure_notify(void);

Esempi

[notify] MyProcedure();

Vedere anche

File di configurazione dell'applicazione (ACF)