RpcNsBindingImportBeginA 함수(rpcnsi.h)

  • 아티클

RpcNsBindingImportBegin 함수는 지정된 인터페이스 및 개체를 제공하는 서버에 대해 클라이언트 호환 바인딩 핸들을 가져오기 위한 가져오기 컨텍스트를 만듭니다.

참고 이 함수는 Windows Vista 이상 운영 체제에서 지원되지 않습니다.
 

구문

RPC_STATUS RpcNsBindingImportBeginA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_IF_HANDLE IfSpec,
  UUID          *ObjUuid,
  RPC_NS_HANDLE *ImportContext
);

매개 변수

EntryNameSyntax

EntryName 구문입니다.

레지스트리 값 항목HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax지정된 구문을 사용하려면 RPC_C_NS_SYNTAX_DEFAULT 지정합니다.

EntryName

호환되는 바인딩 핸들 검색이 시작되는 항목 이름에 대한 포인터입니다.

HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultEntry레지스트리 값 항목에 지정된 항목 이름을 사용하려면 null 포인터 또는 빈 문자열을 제공합니다. 이 경우 EntryNameSyntax 매개 변수는 무시되고 런타임 라이브러리는 기본 구문을 사용합니다.

IfSpec

가져올 인터페이스를 나타내는 스텁 생성 데이터 구조입니다. 인터페이스 사양이 내보내지지 않았거나 호출자에게 문제가 되지 않는 경우 이 매개 변수에 대해 null 값을 지정합니다. 이 경우 반환되는 바인딩은 호환되고 지원되는 프로토콜 시퀀스일 뿐이며 지정된 개체 UUID를 포함하도록 보장됩니다. 연결한 서버가 원하는 인터페이스를 지원하지 않을 수 있습니다.

ObjUuid

선택적 개체 UUID에 대한 포인터입니다.

0이 아닌 UUID의 경우 서버에서 지정된 개체 UUID를 내보낸 경우에만 호환되는 바인딩 핸들이 항목에서 반환됩니다.

ObjUuid에 null 포인터 값 또는 nil UUID가 있는 경우 반환된 바인딩 핸들에는 호환되는 서버에서 내보낸 개체 UUID 중 하나가 포함됩니다. 서버에서 개체 UUID를 내보내지 않은 경우 반환된 호환 바인딩 핸들에는 nil 개체 UUID가 포함됩니다.

ImportContext

RpcNsBindingImportNext 및 RpcNsBindingImportDone 함수에 사용하기 위해 반환된 이름 서비스 핸들입니다.

반환 값

값 의미
RPC_S_OK
 호출이 성공했습니다.
RPC_S_INVALID_NAME_SYNTAX
 이름 구문이 잘못되었습니다.
RPC_S_NAME_SERVICE_UNAVAILABLE
 이름이 최대 길이를 초과합니다.
RPC_S_UNSUPPORTED_NAME_SYNTAX
 이름 구문은 지원되지 않습니다.
RPC_S_INCOMPLETE_NAME
 이름이 불완전합니다.
RPC_S_ENTRY_NOT_FOUND
 이름 서비스 항목을 찾을 수 없습니다.
RPC_S_NAME_SERVICE_UNAVAILABLE
 이름 서비스를 사용할 수 없습니다.
RPC_S_INVALID_OBJECT
 개체가 잘못되었습니다.
 
참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.
 

설명

RpcNsBindingImportNext 함수를 호출하기 전에 클라이언트 애플리케이션은 먼저 RpcNsBindingImportBegin을 호출하여 가져오기 컨텍스트를 만들어야 합니다. 이 함수에 대한 매개 변수는 RpcNsBindingImportNext 함수의 작업을 제어합니다.

바인딩 핸들 가져오기가 완료되면 클라이언트 애플리케이션은 RpcNsBindingImportDone 함수를 호출하여 가져오기 컨텍스트를 삭제합니다.

참고

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

요구 사항

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

추가 정보

RpcNsBindingImportDone

RpcNsBindingImportNext