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의 사용되지 않는 기능이 요청되었습니다.
참고 이 API에 대해 지원되는 프로토콜 시퀀스는 ncalrpc뿐입니다. 다른 프로토콜 시퀀스를 선택하면 이 오류 상태 코드가 반환됩니다.
|
설명
이 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 |