RpcBindingFromStringBinding 함수(rpcdce.h)

RpcBindingFromStringBinding 함수는 바인딩 핸들의 문자열 표현에서 바인딩 핸들을 반환합니다.

구문

RPC_STATUS RpcBindingFromStringBinding(
  RPC_CSTR           StringBinding,
  RPC_BINDING_HANDLE *Binding
);

매개 변수

StringBinding

바인딩 핸들의 문자열 표현에 대한 포인터입니다.

Binding

서버 바인딩 핸들에 대한 포인터를 반환합니다.

반환 값

값	의미
RPC_S_OK	호출이 성공했습니다.
RPC_S_INVALID_STRING_BINDING	문자열 바인딩이 잘못되었습니다.
RPC_S_PROTSEQ_NOT_SUPPORTED	이 호스트에서 프로토콜 시퀀스가 지원되지 않습니다.
RPC_S_INVALID_RPC_PROTSEQ	프로토콜 시퀀스가 잘못되었습니다.
RPC_S_INVALID_ENDPOINT_FORMAT	엔드포인트 형식이 잘못되었습니다.
RPC_S_STRING_TOO_LONG	문자열이 너무 깁니다.
RPC_S_INVALID_NET_ADDR	네트워크 주소가 잘못되었습니다.
RPC_S_INVALID_ARG	인수가 잘못되었습니다.
RPC_S_INVALID_NAF_ID	네트워크 주소 패밀리 식별자가 잘못되었습니다.

 

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

 

설명

RpcBindingFromStringBinding 함수는 바인딩 핸들의 문자열 표현에서 서버 바인딩 핸들을 만듭니다. StringBinding 매개 변수에는 UUID 개체가 포함될 필요가 없습니다. 이 경우 반환된 바인딩에는 nil UUID가 포함됩니다. 제공된 StringBinding 매개 변수에 엔드포인트 필드가 없는 경우 반환된 Binding 매개 변수는 부분적으로 바인딩된 바인딩 핸들입니다. 제공된 StringBinding 매개 변수에 엔드포인트 필드가 포함된 경우 엔드포인트는 잘 알려진 엔드포인트로 간주됩니다. 제공된 StringBinding 매개 변수에 호스트 주소 필드가 없는 경우 반환된 Binding 매개 변수는 로컬 호스트를 참조합니다.

애플리케이션은 RpcStringBindingCompose 함수를 호출하거나 문자 문자열 상수를 제공하여 문자열 바인딩을 만듭니다. 이 메서드로 문자열 바인딩을 만들 때는 서버와의 접촉이 포함되지 않습니다. API의 성공 또는 실패는 서버 가용성을 나타내지 않습니다.

애플리케이션이 Binding 매개 변수를 사용하여 완료되면 애플리케이션은 RpcBindingFree 함수를 호출하여 바인딩 핸들에서 사용하는 메모리를 해제해야 합니다.

요구 사항

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

추가 정보

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBinding

RpcStringBindingCompose