다음을 통해 공유


RPC_BINDING_HANDLE_TEMPLATE_V1_W 구조체(rpcdce.h)

RPC_BINDING_HANDLE_TEMPLATE_V1 구조에는 RPC 바인딩 핸들을 만드는 기본 옵션이 포함되어 있습니다.

구문

typedef struct _RPC_BINDING_HANDLE_TEMPLATE_V1_W {
  unsigned long  Version;
  unsigned long  Flags;
  unsigned long  ProtocolSequence;
  unsigned short *NetworkAddress;
  unsigned short *StringEndpoint;
  union {
    unsigned short *Reserved;
  } u1;
  UUID           ObjectUuid;
} RPC_BINDING_HANDLE_TEMPLATE_V1_W, *PRPC_BINDING_HANDLE_TEMPLATE_V1_W;

멤버

Version

이 구조체의 버전입니다. RPC_BINDING_HANDLE_TEMPLATE_V1 경우 1로 설정해야 합니다.

Flags

RPC 템플릿의 특정 속성을 설명하는 값에 플래그를 지정합니다.

의미
RPC_BHT_OBJECT_UUID_VALID
ObjectUuid 멤버에 유효한 값이 포함되어 있습니다. 이 플래그를 설정하지 않으면 ObjectUuid 멤버에 유효한 UUID가 포함되지 않습니다.

ProtocolSequence

이 바인딩 핸들과 연결된 프로토콜 시퀀스 문자열 리터럴 입니다. 다음 값 중 하나일 수 있습니다.

ncalrpc - 로컬 RPC를 지정합니다. ncacn_ip_tcp - TCP/IP를 통해 RPC를 지정합니다. ncacn_np - 명명된 파이프에 대한 RPC를 지정합니다. ncacn_http - HTTP를 통한 RPC를 지정합니다.

NetworkAddress

바인딩할 네트워크 주소의 문자열 표현에 대한 포인터입니다.

StringEndpoint

바인딩할 엔드포인트의 문자열 표현에 대한 포인터입니다. 동적 엔드포인트를 사용하는 경우 이 멤버를 NULL로 설정합니다. 엔드포인트가 확인되면 RpcBindingToStringBinding을 사용하여 엔드포인트를 가져옵니다.

u1

u1.Reserved

예약되어 있습니다. 이 멤버는 NULL로 설정해야 합니다.

ObjectUuid

원격 개체의 UUID입니다. 이 UUID의 의미 체계는 문자열 바인딩의 의미 체계와 동일합니다. 바인딩 핸들을 만든 후 RpcBindingSetObject를 호출하여 필요에 따라 UUID를 변경합니다.

설명

빠른 바인딩 핸들은 RpcBindingReset 호출 중에 처리되는 방식에서 "클래식" 바인딩 핸들과 약간 다릅니다. RpcBindingReset 은 정적 빠른 바인딩 핸들에 대한 no-op 호출입니다. 그러나 클래식 바인딩 핸들의 경우 RpcBindingReset 은 정적 바인딩 핸들을 동적 바인딩 핸들로 변환하여 이전 버전과의 호환성을 유지합니다.

다음 표에서는 RpcBindingResetRpcEpResolveBinding과 관련하여 정적 및 동적 바인딩 핸들의 동작을 보여 줍니다.

엔드포인트 유형 정적 동적
바인딩 핸들 형식 빠름 클래식 빠름 클래식
RpcBindingReset No-op 동적으로 변환 해결된 엔드포인트가 있는 경우 제거합니다. 해결된 엔드포인트가 있는 경우 제거합니다.
RpcEpResolveBinding No-op No-op 이전에 확인되지 않은 경우 엔드포인트를 확인합니다. 이전에 확인되지 않은 경우 엔드포인트를 확인합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
머리글 rpcdce.h(Rpc.h 포함)

추가 정보

RPC_BINDING_HANDLE

RpcBindingBind

RpcBinding만들기