RpcServerInqBindingHandle 함수(rpcdce.h)
RpcServerInqBindingHandle 함수는 RpcServerInqBindingHandle이 호출되는 스레드에서 서비스하는 RPC 호출에 대한 바인딩 핸들을 가져옵니다.
구문
RPC_STATUS RpcServerInqBindingHandle(
RPC_BINDING_HANDLE *Binding
);
매개 변수
Binding
RPC_BINDING_HANDLERpcServerInqBindingHandle 이 호출되는 스레드에서 서비스하는 호출에 대한 바인딩 핸들을 수신하는 구조체입니다.
호출이 실패하면 이 매개 변수는 정의되지 않습니다.
반환 값
이 함수는 성공에 대한 RPC_S_OK 반환합니다. 그렇지 않으면 RPC_S_* 오류 코드가 반환됩니다. 이 함수는 현재 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 |