RpcStringBindingParse 함수(rpcdce.h)
RpcStringBindingParse 함수는 개체 UUID 부분과 문자열 바인딩의 주소 부분을 별도의 문자열로 반환합니다. 애플리케이션은 RpcStringBindingParse를 호출하여 바인딩 핸들의 문자열 표현을 해당 구성 요소 필드로 구문 분석합니다. RpcStringBindingParse 함수는 개체 UUID 부분과 문자열 바인딩의 주소 부분을 별도의 문자열로 반환합니다.
구문
RPC_STATUS RpcStringBindingParse(
RPC_CSTR StringBinding,
RPC_CSTR *ObjUuid,
RPC_CSTR *Protseq,
RPC_CSTR *NetworkAddr,
RPC_CSTR *Endpoint,
RPC_CSTR *NetworkOptions
);
매개 변수
StringBinding
바인딩의 null로 끝나는 문자열 표현에 대한 포인터입니다.
ObjUuid
개체 UUID의 null로 끝나는 문자열 표현에 대한 포인터에 대한 포인터를 반환합니다.
RpcStringBindingParse가 ObjectUuid 매개 변수를 반환하지 못하도록 NULL 값을 지정합니다. 이 경우 애플리케이션은 RpcStringFree를 호출하지 않습니다.
Protseq
프로토콜 시퀀스의 null로 끝나는 문자열 표현에 대한 포인터에 대한 포인터를 반환합니다. Microsoft RPC 지원 프로토콜 시퀀스 목록은 문자열 바인딩을 참조하세요.
RpcStringBindingParse가 ProtSeq 매개 변수를 반환하지 못하도록 NULL 값을 지정합니다. 이 경우 애플리케이션은 RpcStringFree를 호출하지 않습니다.
NetworkAddr
네트워크 주소의 null로 끝나는 문자열 표현에 대한 포인터에 대한 포인터를 반환합니다. RpcStringBindingParse가 NetworkAddr 매개 변수를 반환하지 못하도록 NULL 값을 지정합니다. 이 경우 애플리케이션은 RpcStringFree를 호출하지 않습니다.
Endpoint
엔드포인트의 null로 끝나는 문자열 표현에 대한 포인터에 대한 포인터를 반환합니다. RpcStringBindingParse가 EndPoint 매개 변수를 반환하지 못하도록 NULL 값을 지정합니다. 이 경우 애플리케이션은 RpcStringFree를 호출하지 않습니다.
NetworkOptions
네트워크 옵션의 null로 끝나는 문자열 표현에 대한 포인터에 대한 포인터를 반환합니다.
RpcStringBindingParse가NetworkOptions 매개 변수를 반환하지 못하도록 NULL 값을 지정합니다. 이 경우 애플리케이션은 RpcStringFree를 호출하지 않습니다.
반환 값
| 값 | 의미 |
|---|---|
|
호출이 성공했습니다. |
|
문자열 바인딩이 잘못되었습니다. |
설명
애플리케이션은 RpcStringBindingParse 루틴을 호출하여 바인딩 핸들의 문자열 표현을 해당 구성 요소 필드로 구문 분석합니다.
RPC 런타임 라이브러리는 반환된 각 구성 요소 문자열에 대한 메모리를 할당합니다. 애플리케이션은 반환된 각 문자열에 대해 RpcStringFree 를 한 번 호출하여 해당 문자열의 메모리 할당을 취소합니다.
StringBinding 매개 변수의 필드가 비어 있으면 RpcStringBindingParse는 해당 출력 매개 변수에 빈 문자열(\0)을 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | rpcdce.h(Rpc.h 포함) |
| 라이브러리 | Rpcrt4.lib |
| DLL | Rpcrt4.dll |