CoInvalidateRemoteMachineBindings 함수(combaseapi.h)

지정된 컴퓨터에 대해 캐시된 RPC 바인딩 핸들을 플러시하도록 서비스 제어 관리자 에게 지시합니다.

관리자만 이 함수를 호출할 수 있습니다.

구문

HRESULT CoInvalidateRemoteMachineBindings(
  [in] LPOLESTR pszMachineName
);

매개 변수

[in] pszMachineName

바인딩 핸들을 플러시해야 하는 컴퓨터 이름 또는 캐시의 모든 핸들을 플러시해야 했음을 나타내는 빈 문자열입니다.

반환 값

이 함수는 다음 값을 반환할 수 있습니다.

반환 코드	Description
S_OK	성공을 나타냅니다.
CO_S_MACHINENAMENOTFOUND	지정된 컴퓨터 이름을 찾을 수 없거나 바인딩 핸들 캐시가 비어 있음을 나타내며, 이는 특정 컴퓨터 이름 대신 빈 문자열이 전달되었음을 나타냅니다.
E_ACCESSDENIED	호출자가 이 컴퓨터의 관리자가 아님을 나타냅니다.
E_INVALIDARG	pszMachineName에 대해 NULL 값이 전달되었음을 나타냅니다.

설명

OLE 서비스 제어 관리자는 COM에서 구성 요소 활성화 요청을 다른 컴퓨터로 보내는 데 사용됩니다. 이를 위해 OLE 서비스 제어 관리자는 컴퓨터 이름으로 키로 지정된 컴퓨터에 활성화 요청을 보내기 위해 RPC 바인딩 핸들의 캐시를 유지 관리합니다. 정상적인 상황에서는 잘 작동하지만 웹 팜 및 부하 분산 상황과 같은 일부 시나리오에서는 동일한 이름으로 다른 물리적 서버에 바인딩하는 데 도움이 되도록 특정 핸들의 이 캐시를 제거하는 기능이 필요할 수 있습니다. CoInvalidateRemoteMachineBindings 가 이 용도로 사용됩니다.

OLE 서비스 제어 관리자는 시간이 지남에 따라 사용되지 않는 바인딩 핸들을 플러시합니다. 이렇게 하려면 CoInvalidateRemoteMachineBindings 를 호출할 필요가 없습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	combaseapi.h(Objbase.h 포함)
라이브러리	Ole32.lib
DLL	Ole32.dll