Compartilhar via

Função CoInvalidateRemoteMachineBindings (combaseapi.h)

  • Artigo

Informa ao gerenciador de controle de serviço para liberar todos os identificadores de associação RPC armazenados em cache para o computador especificado.

Somente os administradores podem chamar essa função.

Sintaxe

HRESULT CoInvalidateRemoteMachineBindings(
  [in] LPOLESTR pszMachineName
);

Parâmetros

[in] pszMachineName

O nome do computador para o qual os identificadores de associação devem ser liberados ou uma cadeia de caracteres vazia para significar que todos os identificadores no cache devem ser liberados.

Retornar valor

Essa função pode retornar os valores a seguir.

Código de retorno Descrição
S_OK
 Indica êxito.
CO_S_MACHINENAMENOTFOUND
 Indica que o nome do computador especificado não foi encontrado ou que o cache do identificador de associação estava vazio, indicando que uma cadeia de caracteres vazia foi passada em vez de um nome de computador específico.
E_ACCESSDENIED
 Indica que o chamador não era um administrador para este computador.
E_INVALIDARG
 Indica que um valor NULL foi passado para pszMachineName.

Comentários

O Gerenciador de Controle de Serviço OLE é usado pelo COM para enviar solicitações de ativação de componentes para outros computadores. Para fazer isso, o Gerenciador de Controle de Serviço OLE mantém um cache de identificadores de associação RPC para enviar solicitações de ativação para o computador, com chave pelo nome do computador. Em circunstâncias normais, isso funciona bem, mas em alguns cenários, como farms da Web e situações de balanceamento de carga, a capacidade de limpar esse cache de identificadores específicos pode ser necessária para facilitar a rea vinculação a um servidor físico diferente com o mesmo nome. CoInvalidateRemoteMachineBindings é usado para essa finalidade.

O Gerenciador de Controle de Serviço OLE liberará identificadores de associação não utilizados ao longo do tempo. Não é necessário chamar CoInvalidateRemoteMachineBindings para fazer isso.

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 combaseapi.h (inclua Objbase.h)
Biblioteca Ole32.lib
DLL Ole32.dll