다음을 통해 공유

RpcStringBindingComposeW 함수(rpcdce.h)

  • 아티클

RpcStringBindingCompose 함수는 문자열 바인딩 핸들을 만듭니다.

통사론

RPC_STATUS RpcStringBindingComposeW(
  RPC_WSTR ObjUuid,
  RPC_WSTR ProtSeq,
  RPC_WSTR NetworkAddr,
  RPC_WSTR Endpoint,
  RPC_WSTR Options,
  RPC_WSTR *StringBinding
);

매개 변수

ObjUuid

UUID개체의 null종료된 문자열 표현에 대한 포인터입니다. 예를 들어 문자열 6B29FC40-CA47-1067-B31D-00DD010662DA는 유효한 UUID를 나타냅니다.

ProtSeq

프로토콜 시퀀스의 null종료된 문자열 표현에 대한 포인터입니다. 참고를 참조하세요.

NetworkAddr

네트워크 주소의 null종료된 문자열 표현에 대한 포인터입니다. 네트워크 주소 형식은 프로토콜 시퀀스와 연결됩니다. 참고를 참조하세요.

Endpoint

엔드포인트의 null종료된 문자열 표현에 대한 포인터입니다. 엔드포인트 형식 및 콘텐츠는 프로토콜 시퀀스와 연결됩니다. 예를 들어 프로토콜 시퀀스 ncacn_np 연결된 엔드포인트는 \pipe\pipename 형식의 파이프 이름입니다. 참고를 참조하세요.

Options

네트워크 옵션의 null종료된 문자열 표현에 대한 포인터입니다. 옵션 문자열은 프로토콜 시퀀스와 연결됩니다. 참고를 참조하세요.

StringBinding

바인딩 핸들의 null-terminated 문자열 표현에 대한 포인터에 대한 포인터를 반환합니다.

RpcStringBindingComposeStringBinding 매개 변수를 반환하지 못하도록 NULL 값을 지정합니다. 이 경우 애플리케이션은 RpcStringFree호출하지 않습니다. 참고를 참조하세요.

참고 자세한 내용은 문자열 바인딩참조하세요.
 

반환 값

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

발언

애플리케이션은 RpcStringBindingCompose 루틴을 호출하여 개체 UUID, 프로토콜 시퀀스, 네트워크 주소, 엔드포인트 및 기타 네트워크 옵션을 바인딩 핸들의 문자열 표현으로 결합합니다.

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

null 매개 변수 값을 지정하거나 데이터가 없는 각 입력 문자열에 대해 빈 문자열(\0)을 제공합니다.

C 언어 문자열 내의 리터럴 백슬래시 문자를 따옴표로 묶어야 합니다. ncacn_np 프로토콜 시퀀스의 서버 이름에 대한 실제 C 문자열은 \\servername으로 표시되고 파이프 이름의 실제 C 문자열은 \pipe\pipename으로 표시됩니다.

메모

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

요구 사항

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

참고 항목

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingParse

RpcStringFree