RpcBindingCreateA 함수(rpcdce.h)

  • 아티클

RpcBindingCreate 함수는 제공된 템플릿을 기반으로 새로운 빠른 RPC 바인딩 핸들을 만듭니다.

구문

RPC_STATUS RpcBindingCreateA(
  [in]           RPC_BINDING_HANDLE_TEMPLATE_V1_A *Template,
  [in, optional] RPC_BINDING_HANDLE_SECURITY_V1_A *Security,
  [in, optional] RPC_BINDING_HANDLE_OPTIONS_V1    *Options,
  [out]          RPC_BINDING_HANDLE               *Binding
);

매개 변수

[in] Template

이 호출에서 만들 바인딩 핸들을 설명하는 RPC_BINDING_HANDLE_TEMPLATE 구조체입니다. 호출 중에 이 데이터를 덮어쓸 수 있으므로 API는 이 데이터에 대한 참조를 유지 관리하지 않습니다. 호출자는 API가 반환할 때 이 구조체에서 사용하는 메모리를 해제해야 합니다.

[in, optional] Security

이 바인딩 핸들의 보안 옵션을 설명하는 RPC_BINDING_HANDLE_SECURITY 구조체입니다. 호출 중에 이 데이터를 덮어쓸 수 있으므로 API는 이 데이터에 대한 참조를 유지 관리하지 않습니다. 호출자는 API가 반환할 때 이 구조체에서 사용하는 메모리를 해제해야 합니다.

이 매개 변수는 선택적 요소입니다. 이 매개 변수를 NULL로 설정하면 RPC_BINDING_HANDLE_SECURITY 대한 기본 보안 설정이 사용됩니다.

[in, optional] Options

바인딩 핸들에 대한 추가 옵션을 설명하는 RPC_BINDING_HANDLE_OPTIONS 구조체입니다. 호출 중에 이 데이터를 덮어쓸 수 있으므로 API는 이 데이터에 대한 참조를 유지 관리하지 않습니다. 호출자는 API가 반환할 때 이 구조체에서 사용하는 메모리를 해제해야 합니다.

이 매개 변수는 선택적 요소입니다. 이 매개 변수를 NULL로 설정하면 RPC_BINDING_HANDLE_OPTIONS 대한 기본 옵션이 사용됩니다.

[out] Binding

새로 만든 바인딩 핸들을 포함하는 RPC_BINDING_HANDLE 구조체입니다. 이 함수가 RPC_S_OK 반환하지 않으면 이 구조체의 내용이 정의되지 않습니다. 로컬이 아닌 RPC 호출의 경우 이 핸들을 RpcBindingBind에 전달해야 합니다.

반환 값

이 함수는 성공에 대한 RPC_S_OK 반환합니다. 그렇지 않으면 RPC_S_* 오류 코드가 반환됩니다. 이러한 오류 코드에 대한 자세한 내용은 RPC 반환 값을 참조하세요.

반환 코드 설명
RPC_S_OK
 바인딩 핸들이 성공적으로 만들어졌습니다.
RPC_S_CANNOT_SUPPORT
 이 바인딩 핸들에 대해 RPC의 사용되지 않는 기능이 요청되었습니다.
참고 이 API에 대해 지원되는 프로토콜 시퀀스는 ncalrpc뿐입니다. 다른 프로토콜 시퀀스를 선택하면 이 오류 상태 코드가 반환됩니다.
 
 
참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.
 

설명

이 API에서 반환된 RPC 바인딩 핸들은 바인딩 핸들을 매개 변수로 허용하는 다른 함수와 함께 사용할 수 있습니다.

그러나 바인딩 핸들에서 호출을 하기 전에 RpcBindingBind를 호출하여 원격 호출에 바인딩 핸들을 사용할 수 있도록 해야 합니다. RpcBindingCreate API는 네트워크를 건드리거나 RPC 서버와 통신을 시도하지 않습니다. 대신 템플릿에 제공된 값을 기반으로 내부 데이터 구조를 빌드합니다. 성공적인 반환은 RPC 서버를 사용할 수 있거나, 액세스할 수 있거나, 올바르게 지정되었음을 나타내지 않습니다.

참고

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

요구 사항

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

추가 정보

RPC_BINDING_HANDLE

RpcBindingBind