Função RpcSsSetClientAllocFree (rpcndr.h)

A função RpcSsSetClientAllocFree habilita os mecanismos de alocação e liberação de memória usados pelos stubs do cliente.

Sintaxe

void RpcSsSetClientAllocFree(
  RPC_CLIENT_ALLOC *ClientAlloc,
  RPC_CLIENT_FREE  *ClientFree
);

Parâmetros

ClientAlloc

Função de alocação de memória.

ClientFree

Função de liberação de memória usada com a função de alocação de memória especificada por pfnAllocate.

Valor retornado

Valor Significado
RPC_S_OUT_OF_MEMORY
O sistema está sem memória.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

Ao substituir as rotinas padrão usadas pelo stub do cliente para gerenciar a memória, RpcSsSetClientAllocFree estabelece os mecanismos de alocação de memória e liberação de memória. Observe que as rotinas padrão são gratuitas e malloc, a menos que a chamada remota ocorra no código do gerenciador. Nesse caso, as rotinas padrão de gerenciamento de memória são RpcSsFree e RpcSsAllocate.

Observe que quando RpcSsSetClientAllocFree recupera os recursos de memória, ele também torna o identificador de contexto NULL.

ObservaçãoRpcSsSetClientAllocFree gera exceções, ao contrário de RpcSmSetClientAllocFree, que retorna o código de erro.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho rpcndr.h (inclua Rpc.h)
Biblioteca Rpcrt4.lib
DLL Rpcrt4.dll

Confira também

RpcSmSetClientAllocFree

RpcSsAllocate

RpcSsFree