mesEncodeIncrementalHandleCreate 函式 (midles.h)

MesEncodeIncrementalHandleCreate 函式會建立編碼，然後將它初始化為串行化的累加樣式。

語法

RPC_STATUS MesEncodeIncrementalHandleCreate(
  void          *UserState,
  MIDL_ES_ALLOC AllocFn,
  MIDL_ES_WRITE WriteFn,
  handle_t      *pHandle
);

參數

UserState

使用者提供之狀態物件的指標，該物件會協調使用者提供的 Alloc、 Write 和 Read 函式。

AllocFn

使用者提供的 Alloc 函式指標。

WriteFn

使用者提供的 Write 函式指標。

pHandle

新建立句柄的指標。

傳回值

值	意義
RPC_S_OK	呼叫成功。
RPC_S_INVALID_ARG	此引數無效。
RPC_S_OUT_OF_MEMORY	記憶體不足。

 

注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。

 

備註

MesEncodeIncrementalHandleCreate 函式是由應用程式用來建立和初始化編碼或譯碼累加樣式的句柄。 使用編碼的累加樣式時，使用者會提供 Alloc 函式來提供空緩衝區，以便放置編碼數據的空白緩衝區，以及在緩衝區已滿或編碼完成時呼叫的 Write 函式。 如需使用者提供 Alloc、 Write 和 Read 函式的其他資訊，請參閱 串行化服務。

使用 -protocol all 或 -protocol ndr64 編譯存根時，而且緩衝區是使用 NDR64 傳輸語法進行編碼時，必須呼叫 MesIncrementalHandleReset 函式，並將其 OpCode 參數設定為 MES_ENCODE_NDR64。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	midles.h (包含 Rpc.h)
程式庫	Rpcrt4.lib
Dll	Rpcrt4.dll

另請參閱

Alloc

MesBufferHandleReset

MesHandleFree

MesIncrementalHandleReset