RpcServerInqBindingHandle 함수(rpcdce.h)

RpcServerInqBindingHandle 함수는 RpcServerInqBindingHandle이 호출되는 스레드에서 서비스하는 RPC 호출에 대한 바인딩 핸들을 가져옵니다.

구문

RPC_STATUS RpcServerInqBindingHandle(
  RPC_BINDING_HANDLE *Binding
);

매개 변수

Binding

RPC_BINDING_HANDLERpcServerInqBindingHandle 이 호출되는 스레드에서 서비스하는 호출에 대한 바인딩 핸들을 수신하는 구조체입니다.

호출이 실패하면 이 매개 변수는 정의되지 않습니다.

반환 값

이 함수는 성공에 대한 RPC_S_OK 반환합니다. 그렇지 않으면 RPC_S_* 오류 코드가 반환됩니다. 이 함수는 현재 RPC 호출을 서비스하지 않는 스레드에서 호출되지 않는 한 실패할 수 없습니다.

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

 

설명

RpcServerInqBindingHandle 은 이 API가 호출된 스레드에서 현재 실행 중인 RPC 호출에 대한 바인딩 핸들을 가져오는 데 사용됩니다. 많은 RPC API에는 입력으로 바인딩 핸들이 필요하므로 바인딩 핸들을 가져오는 편리한 방법입니다.

바인딩 핸들을 매개 변수로 사용하는 모든 서버 쪽 RPC API를 사용하면 NULL을 허용되는 값으로 전달할 수 있습니다. 바인딩 핸들 대신 NULL을 전달하면 현재 동일한 스레드에서 실행 중인 RPC 호출에 대한 바인딩 핸들을 사용해야 합니다. 그러나 별도의 스레드에서 서버 쪽 API를 호출하는 경우 NULL이 아닌 바인딩 핸들을 제공해야 합니다.

명시적 바인딩 핸들을 사용하고 스레드별 컨텍스트 핸들을 사용하지 않는 경우 호출에 대한 바인딩 핸들은 서버 관리자 루틴에 대한 첫 번째 매개 변수입니다. 그러나 명시적 핸들을 사용하지 않거나 컨텍스트 핸들을 사용하는 경우 RpcServerInqBindingHandle 은 다른 스레드에서 사용할 바인딩 핸들을 가져오는 유일한 방법입니다.

비동기 상태는 항상 모든 비동기 RPC 호출에 대한 첫 번째 매개 변수이고 바인딩 핸들은 RpcAsyncGetCallHandle을 사용하여 직접 가져올 수 있으므로 비동기 호출에는 덜 유용하지만 이 API는 비동기 호출 모두에 사용할 수 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	rpcdce.h(Rpc.h 포함)
라이브러리	Rpcrt4.lib
DLL	Rpcrt4.dll

추가 정보

RpcAsyncGetCallHandle