notify 屬性

[notify]屬性會指示 MIDL 編譯器在應用程式的伺服器端產生[notify]程式的呼叫。

[notify] procedure-name();

參數

procedure-name

通知程式將與其相關聯的遠端程式名稱。

備註

呼叫為[notify]屬性結果的[notify]程式會與伺服器上的特定遠端程式相關聯。 其概念類似于回呼函式。 存根會在與它相關聯的遠端程式的所有輸出引數之後呼叫 [notify] 程式,並釋放與參數相關聯的任何記憶體。 如果在伺服器常式執行之前呼叫失敗,則會呼叫 [notify] 常式。 例如,如果伺服器因為從用戶端收到不正確的資料而取消封存期間失敗,則會呼叫 [notify] 常式。

[notify]屬性有助於開發在遠端程式中取得資源的應用程式。 這些資源接著會在遠端程式的輸出參數完全封送處理之後,在 [notify] 程式中釋放。

[notify]程式名稱是_notify尾碼的遠端程式名稱。 _notify程式不需要任何參數,也不會傳回結果。 此程式的原型也會在標頭檔中產生。 例如,如果 IDL 檔案包含下列專案:

MyProcedure([in] short S);

在 ACF for MIDL 中指定下列命令,以產生 _notify 呼叫:

[notify] MyProcedure();

MIDL 編譯器會產生伺服器存根程式碼,其中包含下列 對_notify 程式的呼叫:

MyProcedure_notify();

標頭檔將包含原型:

void MyProcedure_notify(void);

範例

[notify] MyProcedure();

另請參閱

ACF) (應用程式組態檔