Função RpcServerInqBindingHandle (rpcdce.h)

A função RpcServerInqBindingHandle obtém o identificador de associação para chamadas RPC atendidas pelo thread no qual RpcServerInqBindingHandle é chamado.

Sintaxe

RPC_STATUS RpcServerInqBindingHandle(
  RPC_BINDING_HANDLE *Binding
);

Parâmetros

Binding

RPC_BINDING_HANDLE estrutura que, após o êxito, recebe o identificador de associação para a chamada atendida pelo thread no qual RpcServerInqBindingHandle também é chamado.

Se a chamada falhar, esse parâmetro será indefinido.

Valor retornado

Essa função retorna RPC_S_OK em caso de êxito; caso contrário, um código de erro RPC_S_* será retornado. Essa função não pode falhar, a menos que seja chamada em um thread que não esteja atendendo a uma chamada RPC no momento.

Comentários

RpcServerInqBindingHandle é usado para obter o identificador de associação para a chamada RPC que está sendo executada no thread do qual essa API também é chamada. Como muitas APIs RPC exigem um identificador de associação como entrada, essa é uma maneira conveniente de obter um identificador de associação.

Observe que todas as APIs RPC do lado do servidor que assumem um identificador de associação como um parâmetro permitem que você passe NULL como um valor aceito. Passar NULL em vez de um identificador de associação indica que o identificador de associação para a chamada RPC atualmente em execução no mesmo thread deve ser usado. No entanto, se você chamar uma API do lado do servidor de um thread separado, precisará fornecer um identificador de associação não NULL para eles.

Se você usar identificadores de associação explícitos e não usar identificadores de contexto específicos de thread, o identificador de associação para a chamada será o primeiro parâmetro para a rotina do gerenciador do servidor. No entanto, se você não usar identificadores explícitos ou se usar identificadores de contexto, RpcServerInqBindingHandle será a única maneira de obter um identificador de associação a ser usado em outro thread.

Essa API pode ser usada para chamadas assíncronas e síncronas, embora seja menos útil para chamadas assíncronas, pois o identificador de associação pode ser obtido, pois o estado assíncrono é sempre o primeiro parâmetro para todas as chamadas RPC assíncronas e o identificador de associação pode ser obtido diretamente dele usando RpcAsyncGetCallHandle.

Requisitos

Confira também

RpcAsyncGetCallHandle