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();
另請參閱