RpcBindingCopy 함수(rpcdce.h)

  • 아티클

RpcBindingCopy 함수는 바인딩 정보를 복사하고 새 바인딩 핸들을 만듭니다.

구문

RPC_STATUS RpcBindingCopy(
  RPC_BINDING_HANDLE SourceBinding,
  RPC_BINDING_HANDLE *DestinationBinding
);

매개 변수

SourceBinding

참조된 바인딩 정보가 복사되는 서버 바인딩 핸들입니다.

DestinationBinding

복사한 바인딩 정보를 참조하는 서버 바인딩 핸들에 대한 포인터를 반환합니다.

반환 값

값 의미
RPC_S_OK
 호출이 성공했습니다.
RPC_S_INVALID_BINDING
 바인딩 핸들이 잘못되었습니다.
RPC_S_WRONG_KIND_OF_BINDING
 이것은 작업에 대한 잘못된 종류의 바인딩이었습니다.
 
참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.
 

설명

RpcBindingCopy 함수는 SourceBinding 매개 변수에서 참조하는 서버 바인딩 정보를 복사합니다. RpcBindingCopy 는 DestinationBinding 매개 변수를 사용하여 복사된 바인딩 정보에 대한 새 서버 바인딩 핸들을 반환합니다. 또한 RpcBindingCopy 는 SourceBinding 매개 변수의 인증 정보를 DestinationBinding 매개 변수로 복사합니다.

애플리케이션은 한 스레드의 바인딩 정보 변경이 다른 스레드에서 사용하는 바인딩 정보에 영향을 주지 않도록 하려는 경우 RpcBindingCopy 를 사용합니다.

애플리케이션이 RpcBindingCopy를 호출하면 SourceBinding 바인딩 핸들에서 수행된 작업은 DestinationBinding 바인딩 핸들에서 참조하는 바인딩 정보에 영향을 미치지 않습니다. 마찬가지로 DestinationBinding 바인딩 핸들에서 수행되는 작업은 SourceBinding 바인딩 핸들에서 참조하는 바인딩 정보에 영향을 미치지 않습니다.

애플리케이션에서 바인딩 정보에 대한 한 스레드의 변경 내용이 다른 스레드에서 사용하는 바인딩 정보에 영향을 주도록 하려면 애플리케이션이 스레드 간에 단일 바인딩 핸들을 공유해야 합니다. 이 경우 애플리케이션은 바인딩 핸들 동시성 제어를 담당합니다.

DestinationBinding 매개 변수로 지정된 바인딩 핸들을 사용하여 애플리케이션이 완료되면 애플리케이션은 RpcBindingFree 함수를 호출하여 DestinationBinding 바인딩 핸들 및 참조된 바인딩 정보에서 사용하는 메모리를 해제해야 합니다.

참고 Microsoft RPC는 서버 애플리케이션이 아닌 클라이언트 애플리케이션에서만 RpcBindingCopy 를 지원합니다.
 

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows 2000 Server [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 rpcdce.h(Rpc.h 포함)
라이브러리 Rpcrt4.lib
DLL Rpcrt4.dll

추가 정보

RpcBindingFree