RpcBindingToStringBinding 함수(rpcdce.h)
RpcBindingToStringBinding 함수는 바인딩 핸들의 문자열 표현을 반환합니다.
구문
RPC_STATUS RpcBindingToStringBinding(
RPC_BINDING_HANDLE Binding,
RPC_CSTR *StringBinding
);
매개 변수
Binding
바인딩 핸들의 문자열 표현으로 변환할 클라이언트 또는 서버 바인딩 핸들입니다.
StringBinding
Binding 매개 변수에 지정된 바인딩 핸들의 문자열 표현에 대한 포인터에 대한 포인터를 반환합니다.
RpcBindingToStringBinding이 StringBinding 매개 변수를 반환하지 못하도록 null 값을 지정합니다. 이 경우 애플리케이션은 RpcStringFree 함수를 호출하지 않습니다.
반환 값
| 값 | 의미 |
|---|---|
|
호출이 성공했습니다. |
|
바인딩 핸들이 잘못되었습니다. |
참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.
설명
RpcBindingToStringBinding 함수는 클라이언트 또는 서버 바인딩 핸들을 문자열 표현으로 변환합니다.
RPC 런타임 라이브러리는 StringBinding 매개 변수에 반환된 문자열에 대한 메모리를 할당합니다. 애플리케이션은 RpcStringFree 함수를 호출하여 해당 메모리의 할당을 취소합니다.
Binding 매개 변수의 바인딩 핸들에 nil 개체 UUID가 포함된 경우 개체 UUID 필드는 반환된 문자열에 포함되지 않습니다.
반환된 StringBinding 매개 변수를 구문 분석하려면 RpcStringBindingParse 함수를 호출합니다 .
참고 클라이언트의 주소를 쿼리하기 위해 애플리케이션은 RpcBindingServerFromClient 함수를 호출하여 부분적으로 바인딩된 서버 바인딩 핸들을 가져오는 것으로 시작합니다. 서버 바인딩 핸들은 RpcBindingToStringBinding을 호출하여 문자열 바인딩을 가져오는 데 사용할 수 있습니다. 그런 다음 서버는 RpcStringBindingParse를 호출하여 문자열 바인딩에서 클라이언트의 네트워크 주소를 추출할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | rpcdce.h(Rpc.h 포함) |
| 라이브러리 | Rpcrt4.lib |
| DLL | Rpcrt4.dll |