midl_user_allocate屬性

  • 發行項

midl_user_allocate函式是用戶端和伺服器應用程式提供來配置記憶體的函式。

void __RPC_FAR * __RPC_API midl_user_allocate (size_t cBytes);

參數

cBytes

指定要配置的位元組計數。

備註

除非您是在 OSF 相容性 (/osf) 模式中編譯，否則用戶端應用程式和伺服器應用程式都必須實作midl_user_allocate函式。 處理指標所參考的物件時，應用程式和產生的存根會 呼叫midl_user_allocate ：

  • 伺服器應用程式應該呼叫 midl_user_allocate ，以在建立新節點時為應用程式佈建記憶體。例如。
  • 將指向資料取消封存到伺服器位址空間時，伺服器存根會 呼叫 midl_user_allocate 。
  • 當從out指標所參考的伺服器取消封存資料時，用戶端存根會呼叫 midl_user_allocate。 請注意，針對[in]、[out]和[unique]指標，用戶端存根只有在輸入 [unique]指標值為Null時，用戶端存根才會呼叫 midl_user_allocate，並在呼叫期間變更為非Null值。 如果 輸入上的 [unique] 指標不是Null ，用戶端存根會將相關聯的資料寫入現有的記憶體中。

如果 midl_user_allocate 無法配置記憶體，它必須傳回 Null 指標。

建議 midl_user_allocate 傳回對齊 8 個位元組的指標。

範例

#include <windows.h>

void __RPC_FAR * __RPC_API midl_user_allocate(size_t cBytes) 
{ 
    return(malloc(cBytes)); 
}

另請參閱

分配

陣 列

陣列和指標

陣列和Sized-Pointer屬性

in

midl_user_free

/osf

out

Ptr

ref

獨特