Compartilhar via

Função I_RpcBindingInqLocalClientPID (rpcdcep.h)

  • Artigo

[A função I_RpcBindingInqLocalClientPID está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Em vez disso, chame RpcServerInqCallAttributes.]

A função I_RpcBindingInqLocalClientPID obtém uma ID de processo do cliente.

Sintaxe

RPC_STATUS I_RpcBindingInqLocalClientPID(
  [in, optional] RPC_BINDING_HANDLE Binding,
  [out]          unsigned long      *Pid
);

Parâmetros

[in, optional] Binding

RPC_BINDING_HANDLE que especifica o identificador de associação para uma associação RPC explícita do cliente para um aplicativo de servidor.

[out] Pid

Contém a ID do processo do cliente que emitiu a chamada no retorno.

Valor retornado

Valor Significado
RPC_S_OK
 A chamada de função foi bem-sucedida.
RPC_S_NO_CALL_ACTIVE
 O thread atual não tem uma chamada RPC ativa.
RPC_S_INVALID_BINDING
 O identificador de associação RPC é inválido.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

A ID do processo do cliente só é retornada em ClientBinding quando a sequência de protocolo "ncalrpc" é usada. Até que o processo seja encerrado, o valor da ID do processo o identifica exclusivamente no cliente. Quando o processo é encerrado, a ID do processo pode ser usada por novos processos.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho rpcdcep.h (inclua Rpc.h)
Biblioteca Rpcrt4.lib
DLL Rpcrt4.dll