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