共用方式為

CoInvalidateRemoteMachineBindings 函式 (combaseapi.h)

  • 發行項

告知 服務控制管理員 排清指定計算機的任何快取 RPC 系結句柄。

只有系統管理員可以呼叫此函式。

語法

HRESULT CoInvalidateRemoteMachineBindings(
  [in] LPOLESTR pszMachineName
);

參數

[in] pszMachineName

應該排清系結句柄的計算機名稱，或表示應該排清快取中所有句柄的計算機名稱。

傳回值

此函式可以傳回下列值。

傳回碼 描述
S_OK
 表示成功。
CO_S_MACHINENAMENOTFOUND
 表示找不到指定的計算機名稱，或系結句柄快取是空的，表示已傳遞空字串，而不是特定的計算機名稱。
E_ACCESSDENIED
 表示呼叫端不是這部計算機的系統管理員。
E_INVALIDARG
 表示已針對 pszMachineName 傳遞 NULL 值。

備註

COM 會使用 OLE Service Control Manager 將元件啟用要求傳送給其他計算機。 若要這樣做，OLE Service Control Manager 會維護 RPC 系結句柄的快取，以將啟用要求傳送至計算機，並依計算機名稱進行密鑰處理。 在正常情況下，這可正常運作，但在某些情況下，例如 Web 伺服器陣列和負載平衡情況，可能需要清除特定句柄的這個快取，以便以相同名稱重新系結至不同的實體伺服器。 CoInvalidateRemoteMachineBindings 用於此用途。

OLE Service Control Manager 會排清一段時間未使用的系結句柄。 不需要呼叫 CoInvalidateRemoteMachineBindings 來執行此動作。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 combaseapi.h (包含 Objbase.h)
程式庫 Ole32.lib
Dll Ole32.dll