RpcMgmtEpUnregister 함수(rpcdce.h)

[이 함수는 Windows NT 및 Windows Me/98/95에서만 지원되며 다른 버전의 Windows에서 EP_S_CANT_PERFORM_OP 반환합니다.]

RpcMgmtEpUnregister 함수는 엔드포인트 맵에서 서버 주소 정보를 제거합니다.

구문

RPC_STATUS RpcMgmtEpUnregister(
  RPC_BINDING_HANDLE EpBinding,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE Binding,
  UUID               *ObjectUuid
);

매개 변수

EpBinding

엔드포인트 맵 요소를 등록 취소할 호스트입니다. 호출하는 애플리케이션과 동일한 호스트에서 요소를 제거하기 위해 애플리케이션은 NULL 값을 지정합니다. 다른 호스트에서 요소를 제거하기 위해 애플리케이션은 해당 호스트에 있는 모든 서버에 대한 서버 바인딩 핸들을 지정합니다. 애플리케이션은 다른 원격 프로시저 호출에 사용하는 것과 동일한 바인딩 핸들을 지정할 수 있습니다.

IfId

엔드포인트 맵에서 제거할 인터페이스 식별자입니다.

Binding

제거할 바인딩 핸들입니다.

ObjectUuid

제거할 선택적 개체 UUID입니다. NULL 값은 제거할 개체 UUID가 없음을 나타냅니다.

반환 값

반환 코드	설명
RPC_S_OK	호출이 성공했습니다.
RPC_S_CANT_PERFORM_OP	요청된 작업을 수행할 수 없습니다.

 

참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.

 

설명

RpcMgmtEpUnregister 함수는 엔드포인트 맵에서 요소의 등록을 취소합니다. 관리 프로그램은 이 함수를 호출하여 더 이상 사용할 수 없는 서버의 주소를 제거하거나 더 이상 제공되지 않는 개체를 지원하는 서버의 주소를 제거합니다.

EpBinding 매개 변수는 전체 바인딩이어야 합니다. EpBinding 매개 변수와 연결된 개체 UUID는 nil UUID여야 합니다. Nil이 아닌 UUID를 지정하면 상태 코드 EPT_S_CANT_PERFORM_OP 함수가 실패합니다. 호스트 정보 및 개체 UUID 외에 이 인수의 모든 정보는 무시됩니다.

애플리케이션은 RpcMgmtEpEltInqNext 를 호출하여 로컬 엔드포인트 맵 요소를 봅니다. 그런 다음, 애플리케이션은 RpcMgmtEpUnregister를 사용하여 요소를 제거할 수 있습니다.

참고 이 함수는 주의해서 사용합니다. 로컬 엔드포인트 맵에서 요소를 제거하면 서버에 대한 바인딩 핸들이 아직 없는 클라이언트 애플리케이션에서 서버를 사용할 수 없게 될 수 있습니다.

 

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	rpcdce.h(Rpc.h 포함)
라이브러리	Rpcrt4.lib
DLL	Rpcrt4.dll

추가 정보

RpcEpRegister

RpcEpUnregister

RpcMgmtEpEltInqNext