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를 호출하지 않습니다.

반환 값

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

설명

애플리케이션은 RpcStringBindingParse 루틴을 호출하여 바인딩 핸들의 문자열 표현을 해당 구성 요소 필드로 구문 분석합니다.

RPC 런타임 라이브러리는 반환된 각 구성 요소 문자열에 대한 메모리를 할당합니다. 애플리케이션은 반환된 각 문자열에 대해 RpcStringFree 를 한 번 호출하여 해당 문자열의 메모리 할당을 취소합니다.

StringBinding 매개 변수의 필드가 비어 있으면 RpcStringBindingParse는 해당 출력 매개 변수에 빈 문자열(\0)을 반환합니다.

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

요구 사항

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

추가 정보

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingCompose

RpcStringFree