다음을 통해 공유

RpcBindingToStringBindingA 함수(rpcdce.h)

  • 아티클

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

통사론

RPC_STATUS RpcBindingToStringBindingA(
  RPC_BINDING_HANDLE Binding,
  RPC_CSTR           *StringBinding
);

매개 변수

Binding

바인딩 핸들의 문자열 표현으로 변환할 클라이언트 또는 서버 바인딩 핸들입니다.

StringBinding

Binding 매개 변수에 지정된 바인딩 핸들의 문자열 표현에 대한 포인터를 반환합니다.

RpcBindingToStringBindingStringBinding 매개 변수를 반환하지 않도록 null 값을 지정합니다. 이 경우 애플리케이션은 RpcStringFree 함수를 호출하지 않습니다.

반환 값

값 의미
RPC_S_OK
 호출이 성공했습니다.
RPC_S_INVALID_BINDING
 바인딩 핸들이 잘못되었습니다.
 
참고 유효한 오류 코드 목록은 RPC 반환 값참조하세요.
 

발언

RpcBindingToStringBinding 함수는 클라이언트 또는 서버 바인딩 핸들을 문자열 표현으로 변환합니다.

RPC 런타임 라이브러리는 StringBinding 매개 변수에 반환된 문자열에 대한 메모리를 할당합니다. 애플리케이션은 RpcStringFree 함수를 호출하여 해당 메모리의 할당을 취소합니다.

Binding 매개 변수의 바인딩 핸들에 UUIDnil 개체가 포함된 경우 개체 UUID 필드는 반환된 문자열에 포함되지 않습니다.

반환된 StringBinding 매개 변수를 구문 분석하려면 RpcStringBindingParse 함수를 호출합니다.

참고 클라이언트의 주소를 쿼리하려면 애플리케이션이 RpcBindingServerFromClient 함수를 호출하여 부분적으로 바인딩된 서버 바인딩 핸들을 가져오는 것으로 시작합니다. 서버 바인딩 핸들은 RpcBindingToStringBinding을 호출하여 문자열 바인딩을 가져오는 데 사용할 수 있습니다. 그런 다음, 서버는 RpcStringBindingParse를 호출하여 문자열 바인딩에서 클라이언트의 네트워크 주소를 추출할 수 있습니다.
 

메모

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

요구 사항

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

참고 항목

RpcBindingFromStringBinding

RpcStringBindingParse

RpcStringFree