RpcBindingFree 함수(rpcdce.h)

아티클
03/15/2023

RpcBindingFree 함수는 바인딩 핸들 리소스를 해제합니다.

구문

RPC_STATUS RpcBindingFree(
  RPC_BINDING_HANDLE *Binding
);

매개 변수

Binding

해제할 서버 바인딩에 대한 포인터입니다.

반환 값

값	의미
RPC_S_OK	호출이 성공했습니다.
RPC_S_INVALID_BINDING	바인딩 핸들이 잘못되었습니다.
RPC_S_WRONG_KIND_OF_BINDING	작업에 대한 잘못된 종류의 바인딩이었습니다.

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

설명

RpcBindingFree 함수는 서버 바인딩 핸들에서 사용하는 메모리를 해제합니다. 프로그램 실행 중에 동적으로 생성된 참조된 바인딩 정보도 릴리스됩니다. 애플리케이션은 바인딩 핸들 사용을 마치면 RpcBindingFree 함수를 호출합니다. 핸들을 사용하는 모든 호출이 완료될 때까지 RPC 바인딩 핸들을 해제하면 안 됩니다. 이렇게 하지 않으면 예기치 않은 결과가 발생합니다.

바인딩 핸들은 다음 함수를 호출하여 동적으로 생성됩니다.

작업이 바인딩을 해제하면 Binding 매개 변수는 NULL 값을 반환합니다.

참고 Microsoft RPC는 RpcBindingServerFromClient 로 생성된 바인딩 핸들에 대한 클라이언트 애플리케이션 또는 서버 애플리케이션에서만 RpcBindingFree를 지원합니다.

요구 사항


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