다음을 통해 공유

RpcBindingFromStringBindingA 함수(rpcdce.h)

  • 아티클

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

통사론

RPC_STATUS RpcBindingFromStringBindingA(
  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 함수를 호출하여 바인딩 핸들에서 사용하는 메모리를 해제해야 합니다.

메모

rpcdce.h 헤더는 RpcBindingFromStringBinding을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

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

참고 항목

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBinding

RpcStringBindingCompose